# Guides

Task-oriented guides for the Archive GraphQL API. Start with Getting started, then pick the guide that matches what you're building. For field-level detail, see the [API reference](/api/v2/docs/queries).

- [Getting started](/api/v2/docs/guides/getting-started) — Make your first Archive API call. Authenticate, select a workspace, and fetch a page of content.
- [Core concepts](/api/v2/docs/guides/concepts) — The Archive data model — workspaces, items, creators and social profiles, Collections and views, custom attributes — and the terms the app and the API spell differently.
- [Authentication](/api/v2/docs/guides/authentication) — Authenticate Archive API requests with a bearer token, and create, rotate, and store tokens securely.
- [Workspaces](/api/v2/docs/guides/workspaces) — 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) — Page through Archive connections with first/after cursors and pageInfo, stay within the page-size bounds, and keep pagination cheap.
- [Filtering & search](/api/v2/docs/guides/filtering) — 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) — Compare the plan ladder, price your own query with the calculator, read the RateLimit headers, and back off correctly.
- [Errors](/api/v2/docs/guides/errors) — 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) — Subscribe an HTTPS endpoint to new content landing in your views, verify signed deliveries, and recover from failures without losing events.
- [Alpha features](/api/v2/docs/guides/alpha-features) — How the X-Archive-Alpha-Features opt-in header works, how alpha surfaces are hidden by default, and the no-stability-contract policy.
- [Changelog](/api/v2/docs/guides/changelog) — The /api/v2 stability contract, and a reverse-chronological record of changes to the Archive API surface and these guides.