ListDrop public API
API by ListDrop · rest
ListDrop is a social app for living lists (you follow lists, not people). This spec covers the keyless, anonymous surface built for AI agents: create a private draft list and hand the user a claim URL (they keep it with one click), and read public lists and topic hubs as markdown. Auth is optional: everything works keyless (the claim-URL flow keeps credentials out of agents' hands), and agents that should act on a user's own account can connect via OAuth 2.1 — authorization-code + PKCE, dynamic client registration (RFC 7591), metadata at /.well-known/oauth-authorization-server (RFC 8414) and /.well-known/oauth-protected-resource (RFC 9728). The same capabilities are exposed as an MCP server (see x-mcp). Versioning: the path carries the major version (/api/v1/…); breaking changes ship as /api/v2 and v1 keeps working for at least 90 days, announced with Deprecation and Sunset headers on v1 responses (see x-versioning). Every v1 response carries API-Version plus RateLimit /…
Endpoint: https://www.listdrop.co/
Verification: observed. Source: crawl.
Capabilities (15)
- Create a list (keyless draft + claim URL or directly in the connected account)
- Describe the feedback endpoint
- Tell the ListDrop team what broke or what's missing
- Read a public list as JSON
- Read a list's email guest list
- Replace a list's email guest list
- Bulk add update remove and reorder items
- Subscribe a webhook to a list's changes
- List the connected user's own lists
- Read a topic hub as JSON
- List the connected account's webhooks
- Delete a webhook
- Read a public list as markdown
- This specification
- Read a topic hub as markdown