# Archipad API Documentation

> Reference documentation of the Archipad APIs, GraphQL and REST, and how a client authenticates to call them.

Every API links to its machine-readable description: a GraphQL schema in SDL or an OpenAPI document in JSON. The GraphQL and REST APIs take the same OAuth 2.0 access tokens, described in the authentication guide.

## Guides

- [Authentication](https://docs.archipad.dev/authentication.md): Get an OAuth 2.0 token from the Archipad identity provider, on behalf of a user or server to server, and call the GraphQL and REST APIs with it.

## APIs

- [Archipad API, GraphQL schema](https://docs.archipad.dev/apis/archipad-graphql.graphql): GraphQL schema of the Archipad API: queries, mutations and types. Version 0.1.0, a preview: it may change at any time, breaking changes included. GraphQL SDL. Queries are sent to https://api.archipad.dev/graphql. Reference in Markdown, one page per operation and type, listed in: https://docs.archipad.dev/apis/archipad-graphql.md
  - [Pagination guide](https://docs.archipad.dev/apis/archipad-graphql/guides/pagination.md): Page through a list with `first` and `after`, keep the arguments of the first page, and read what the filters of a list mean.
