Saved Workspace
A Pro dimension — per-user saved searches, lists, and net-new deltas. The same capability the MCP exposes as tools; turns apis.io from stateless lookup into a persistent research workspace. Requires an API key.
Create a saved search.
Persist a named search using the same filter vocabulary as /search. Pro.
Headers
Idempotency-KeyA client-generated key that makes this write safe to retry. Send the same key on a retry and the FIRST response is replayed verbatim — the same id, not a second object. Scoped to your API key and remembered for 24 hours. Responses to a replay carry Idempotency-Replayed: true.
Create a saved search. › Request Body
nameqtagsbandindustryregionareaartifact_typesmatchmin_scoreCreate a saved search. › Responses
The created saved search (id, name, criteria).
What's NEW for a saved search since you last checked.
Providers that newly match your criteria since the previous call. Advances the delta cursor, so each call reports only the change. The first call establishes the baseline (net-new empty). The agent-native version of the demand report. Pro.
path Parameters
idWhat's NEW for a saved search since you last checked. › Responses
Net-new matches + advanced cursor.
Create a named, persistent list.
Creates a shortlist/stack you own; seed it with provider slugs and/or aids. Pro.
Headers
Idempotency-KeyA client-generated key that makes this write safe to retry. Send the same key on a retry and the FIRST response is replayed verbatim — the same id, not a second object. Scoped to your API key and remembered for 24 hours. Responses to a replay carry Idempotency-Replayed: true.
Create a named, persistent list. › Request Body
namemembersProvider slugs and/or aids.
Create a named, persistent list. › Responses
The created list.
Add providers/APIs to a list.
Appends providers/APIs (by slug or aid) to the list, de-duplicated. Pro.
path Parameters
idHeaders
Idempotency-KeyA client-generated key that makes this write safe to retry. Send the same key on a retry and the FIRST response is replayed verbatim — the same id, not a second object. Scoped to your API key and remembered for 24 hours. Responses to a replay carry Idempotency-Replayed: true.
Add providers/APIs to a list. › Responses
Updated list (count + added).
Your workspace root — plan, counts, and where things live.
What you have saved here and where to find it, plus the plan you are on. NOT the account: login, API key, usage and billing live at /v1/auth/me, which authenticates with a session rather than a key. Counts rather than contents — a root that inlined every saved search would be the heaviest response here for a caller who mostly wants to know where things are. A count that cannot be read comes back as null with a note, never as a zero and never as an error: the urls are still true when the store is not reachable.
Your workspace root — plan, counts, and where things live. › Responses
The workspace root.
usernote