{
  "openapi": "3.1.0",
  "info": {
    "title": "monday.com API",
    "version": "2024-10",
    "description": "monday.com's platform API — a GraphQL endpoint for managing boards, items, columns, users, and workflows.",
    "contact": {
      "name": "monday.com Developer Support",
      "url": "https://developer.monday.com"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://monday.com/l/legal/developer-terms"
    }
  },
  "servers": [
    {
      "url": "https://api.monday.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/v2": {
      "post": {
        "operationId": "graphql",
        "summary": "Execute a GraphQL query or mutation",
        "description": "The single endpoint for all monday.com API operations. Send GraphQL queries and mutations as JSON in the request body.",
        "security": [
          { "bearerAuth": [] }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Client-generated key (UUID recommended) that makes mutations idempotent. On the first request the response is cached for 30 minutes; retries with the same key return the cached response without re-executing the mutation. Ignored on queries. A concurrent request with the same key returns 409 until the first completes.",
            "schema": {
              "type": "string"
            },
            "example": "550e8400-e29b-41d4-a716-446655440000"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GraphQLRequest"
              },
              "examples": {
                "query_boards": {
                  "summary": "List boards",
                  "value": {
                    "query": "query { boards(limit: 5) { id name } }"
                  }
                },
                "create_item": {
                  "summary": "Create an item",
                  "value": {
                    "query": "mutation ($boardId: ID!, $itemName: String!) { create_item(board_id: $boardId, item_name: $itemName) { id name } }",
                    "variables": { "boardId": "1234567890", "itemName": "New task" }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "GraphQL response",
            "headers": {
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "RateLimit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "Idempotency-Replayed": {
                "$ref": "#/components/headers/Idempotency-Replayed"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GraphQLResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized — missing or invalid token"
          },
          "409": {
            "description": "Idempotency conflict — a request with the same Idempotency-Key is already in flight. Wait the number of seconds indicated by Retry-After before retrying.",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before retrying the request.",
                "schema": { "type": "integer" }
              }
            }
          },
          "429": {
            "description": "Rate limited — complexity budget or minute/daily quota exceeded",
            "headers": {
              "RateLimit-Policy": {
                "$ref": "#/components/headers/RateLimit-Policy"
              },
              "RateLimit": {
                "$ref": "#/components/headers/RateLimit"
              }
            }
          }
        }
      }
    },
    "/v2/get_schema": {
      "get": {
        "operationId": "getSchema",
        "summary": "Get the GraphQL schema",
        "description": "Returns the full GraphQL schema. Use format=sdl for SDL text, or omit for introspection JSON. No authentication required.",
        "security": [],
        "parameters": [
          {
            "name": "format",
            "in": "query",
            "required": false,
            "description": "Response format. Use \"sdl\" for Schema Definition Language text. Omit for introspection JSON.",
            "schema": {
              "type": "string",
              "enum": ["sdl"]
            }
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "API schema version to retrieve.",
            "schema": {
              "type": "string"
            },
            "example": "2026-04"
          }
        ],
        "responses": {
          "200": {
            "description": "GraphQL schema",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "GraphQL introspection result (default format)"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "description": "GraphQL SDL schema (when format=sdl)"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "headers": {
      "RateLimit-Policy": {
        "description": "Declares the active rate-limit policies for the account tier. Present on every response. Follows IETF RateLimit Headers structured-field format. Policies: `minuteRate` (requests per minute, w=60), `concurrency` (concurrent requests, qu=\"concurrent-requests\"), `complexityMinute` (complexity budget, qu=\"content-bytes\").",
        "schema": { "type": "string" },
        "example": "\"minuteRate\";q=100;w=60, \"concurrency\";q=40;qu=\"concurrent-requests\", \"complexityMinute\";q=1000000;w=60;qu=\"content-bytes\""
      },
      "RateLimit": {
        "description": "Reports the current state of each rate limit. `r` is remaining quota; `t` (seconds until reset) is included when a limit is exceeded or reset time is available. Present on every response.",
        "schema": { "type": "string" },
        "example": "\"minuteRate\";r=90, \"concurrency\";r=35, \"complexityMinute\";r=800000;t=45"
      },
      "Idempotency-Replayed": {
        "description": "Set to `true` when the response was served from the idempotency cache rather than re-executing the mutation.",
        "schema": { "type": "boolean" }
      }
    },
    "schemas": {
      "GraphQLRequest": {
        "type": "object",
        "required": ["query"],
        "properties": {
          "query": {
            "type": "string",
            "description": "The GraphQL query or mutation string"
          },
          "variables": {
            "type": "object",
            "description": "Variables for the GraphQL operation",
            "additionalProperties": true
          },
          "operationName": {
            "type": "string",
            "description": "Name of the operation to execute (when query contains multiple operations)"
          }
        }
      },
      "GraphQLResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "description": "The result of the GraphQL operation",
            "additionalProperties": true
          },
          "errors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GraphQLError"
            },
            "description": "Errors encountered during execution"
          }
        }
      },
      "GraphQLError": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "line": { "type": "integer" },
                "column": { "type": "integer" }
              }
            }
          },
          "extensions": {
            "type": "object",
            "additionalProperties": true
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Personal API token or OAuth access token passed in the Authorization header"
      }
    }
  },
  "externalDocs": {
    "description": "monday.com API Documentation",
    "url": "https://developer.monday.com/api-reference/reference/about-the-api-reference"
  }
}