AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.
API Overview
Query and mutate Done Bear resources over the GraphQL API.
The Done Bear API uses GraphQL for all queries and mutations. Send authenticated requests to the GraphQL endpoint to manage workspaces, tasks, projects, teams, labels, and API keys.
Base URL
All API requests go to:
curl https://api.donebear.com/graphql \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
--data '{"query":"query { viewer { id email } }"}'Authentication
Send bearer credentials in the Authorization header. The API accepts:
- Done Bear API keys that start with
db_ - Supabase JWTs
Example:
curl https://api.donebear.com/graphql \
-H "Authorization: Bearer <token-or-api-key>" \
-H "Content-Type: application/json" \
--data '{"query":"query { myWorkspaces { id name } }"}'Machine-readable catalog
The OpenAPI 3.1 specification is published at:
- https://donebear.com/openapi.json
- https://donebear.com/api/openapi.yaml
- https://api.donebear.com/openapi.json
It lists unique operationIds, typed request and response schemas, and the read, write, and admin security scopes.
Next steps
- Follow Authenticate API requests to set up credentials.
- Read API scopes before creating a key for an agent.
- Use GraphQL reference for the full list of queries and mutations.
- Read API versioning for the
Api-Versionheader,@deprecated, and sunset rules. - See Done Bear developer resources for the full catalog.
Published with Blode.md