---
title: "Execute a GraphQL query or mutation"
method: POST
path: "/v2"
---

# Execute a GraphQL query or mutation

`POST /v2`

The single endpoint for all monday.com API operations. Send GraphQL queries and mutations as JSON in the request body.

## Headers

- `Idempotency-Key` string

## Request body

- GraphQLRequest
  - `query` string, required — The GraphQL query or mutation string
  - `variables` object — Variables for the GraphQL operation
  - `operationName` string — Name of the operation to execute (when query contains multiple operations)

## Response `200`

GraphQL response

- GraphQLResponse
  - `data` object — The result of the GraphQL operation
  - `errors` GraphQLError[] — Errors encountered during execution
    - `message` string
    - `locations` object[]
      - `line` integer
      - `column` integer
    - `extensions` object

## Other responses

- `401` — Unauthorized — missing or invalid token
- `409` — Idempotency conflict — a request with the same Idempotency-Key is already in flight. Wait the number of seconds indicated by Retry-After before retrying.
- `429` — Rate limited — complexity budget or minute/daily quota exceeded

---

[API](https://skmtc.dev/monday/apis/monday-com-api.md) · [All operations](https://skmtc.dev/monday/apis/monday-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/monday/monday-com-api/revisions/7dd6de55d1b1/schema)