GraphQL · POST /api/v2
Archive API documentation
Read and update your Archive workspace with GraphQL. Work with items, creators, collections,
views, and campaigns. To connect an AI assistant, use the
MCP server at /api/v2/mcp.
Create an API token in Archive's Integration tab, then replace the example token below with yours.
Listing workspaces does not require the example's WORKSPACE-ID header.
Follow Getting started for the full setup.
curl https://app.archive.com/api/v2 \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
-H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
-d '{
"query": "query WorkspacesDefault($first: Int, $after: String) {\n workspaces(first: $first, after: $after) {\n totalCount\n edges {\n node {\n id\n name\n }\n }\n pageInfo {\n hasNextPage\n endCursor\n }\n }\n}",
"variables": {
"first": 10
}
}' Guides
Make your first request, choose a workspace, and learn how to filter results,
fetch pages, and handle errors.
Start with Getting started → API reference
Look up queries, mutations, types, and examples. The reference is generated from the API schema.
43 queries 54 mutations 165 types MCP server
Connect your AI assistant to 96 tools for reading and updating workspace data.
Each tool links to its GraphQL reference.
Connect a client → Explorer
Try API requests in your browser. Open an example from the reference, add your credentials,
and run it.
Open the explorer →
Documentation for agents
Start with llms.txt for links to the guides and API reference
in Markdown. For a guide or reference page, add .md to its URL to read the Markdown
version. Read Agent conventions before using MCP tools
to change data.