---
title: "Execute a GraphQL operation"
method: POST
path: "/graphql"
tags: ["GraphQL"]
---

# Execute a GraphQL operation

`POST /graphql`

## Request

- Base URL: `https://api.donebear.com`
- URL: `https://api.donebear.com/graphql`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://mcp.donebear.com/authorize`, token URL `https://mcp.donebear.com/token`, scopes: `read`)

Execute a GraphQL query or mutation. Rate limit: 100 requests per 60 seconds per IP. Query depth: 10.

## Headers

- `Api-Version` '1'

## Request body

- GraphQLRequest
  - `query` string, required
  - `variables` object

## Response `200`

GraphQL execution result.

- GraphQLResponse
  - `data` object, nullable
  - `errors` object[]

---

[API](https://skmtc.dev/donebear/apis/done-bear-api.md) · [All operations](https://skmtc.dev/donebear/apis/done-bear-api/llms.txt) · [OpenAPI document](https://skmtc.dev/donebear/apis/done-bear-api/revisions/91de7e02be0d?raw)