# Archive API

> The Archive API is a GraphQL API (`POST /api/v2`) and an MCP server (`/api/v2/mcp`) over the creator-marketing data in an Archive workspace. Every link below is the page's Markdown rendition.

## Guides

- [Getting started](/api/v2/docs/guides/getting-started.md) — Make your first Archive API call. Authenticate, select a workspace, and fetch a page of content.
- [Core concepts](/api/v2/docs/guides/concepts.md) — Understand workspaces, items, creators, social profiles, Collections, views, and custom attributes, including differences between app and API terminology.
- [Authentication](/api/v2/docs/guides/authentication.md) — Authenticate Archive API requests with a bearer token, and create, rotate, and store tokens securely.
- [Workspaces](/api/v2/docs/guides/workspaces.md) — Select a workspace with the WORKSPACE-ID header, learn which operations are workspace-scoped, and handle missing or unknown workspaces.
- [Pagination](/api/v2/docs/guides/pagination.md) — Fetch successive pages with first, after, and pageInfo. Check page-size limits and handle lists without cursors.
- [Filtering & search](/api/v2/docs/guides/filtering.md) — Narrow the items query with date and engagement ranges, semantic super-search, custom-attribute conditions, sorting, and saved views.
- [Rate limits & plans](/api/v2/docs/guides/rate-limits.md) — Check request and query-cost limits by plan, estimate query cost, read response headers, and retry rate-limited requests.
- [Errors](/api/v2/docs/guides/errors.md) — Distinguish transport errors from GraphQL errors, read the userErrors pattern on mutations, and map each HTTP status to its cause.
- [Webhooks](/api/v2/docs/guides/webhooks.md) — Receive content and operation events at an HTTPS endpoint, verify signatures, and recover missed deliveries.
- [Importing creators](/api/v2/docs/guides/creator-import.md) — Import creators by social handle, check each result, and retry a request without creating a duplicate import.
- [Labels](/api/v2/docs/guides/labels.md) — Manage creator labels by name, choose between immediate and background updates, and check when a change finishes.
- [Alpha features](/api/v2/docs/guides/alpha-features.md) — Try experimental API features with the X-Archive-Alpha-Features header and understand their limits.
- [Changelog](/api/v2/docs/guides/changelog.md) — Changes to the Archive API and guides, newest first, with the API stability and versioning policy.

## API reference

- [Queries](/api/v2/docs/queries.md) — Every query root field.
- [Mutations](/api/v2/docs/mutations.md) — Every mutation root field.
- [Types](/api/v2/docs/types.md) — Every object, input, enum, and scalar type.

## MCP

- [Overview](/api/v2/docs/mcp/overview.md) — Connect an AI agent to Archive to search content, read creator profiles, and manage data with the same permissions as the GraphQL API.
- [Use with Claude](/api/v2/docs/mcp/use-with-claude.md) — Connect Archive to Claude.ai, Claude Desktop, or Claude Code, choose permissions, and test the connection.
- [Use with ChatGPT](/api/v2/docs/mcp/use-with-chatgpt.md) — Connect Archive to ChatGPT or Codex, choose permissions, and test the connection.
- [Connect a client](/api/v2/docs/mcp/connect.md) — Connect an MCP client with an API token or OAuth, select a workspace, and send requests using Archive's supported protocol versions.
- [Agent conventions](/api/v2/docs/mcp/conventions.md) — Check write results, retry safely, choose response fields, and work with saved views through Archive MCP tools.
- [Example prompts](/api/v2/docs/mcp/example-prompts.md) — Working prompts for the Archive MCP server — content ranking, creator lookup, saving a view, importing a post, and a structured weekly-report workflow.
- [Read tools](/api/v2/docs/mcp/read-tools.md) — 42 tools for reading workspace data. Find each tool and its GraphQL query.
- [Write tools](/api/v2/docs/mcp/write-tools.md) — 54 tools for changing workspace data. Check write permissions and when to confirm an action.
- [Troubleshooting](/api/v2/docs/mcp/troubleshooting.md) — Common Archive MCP problems and their fixes — 401s, missing tools, unresolved workspaces, empty result sets, rejected writes, throttles, and client-specific issues.
- [Security & data handling](/api/v2/docs/mcp/security.md) — How the Archive MCP server authenticates requests, isolates workspaces, audits writes, and what data a connected agent can reach.
- [Support & contact](/api/v2/docs/mcp/support.md) — How to reach Archive about the MCP server, what to include in a report, and what to check first.