{
  "openapi": "3.1.0",
  "info": {
    "title": "Switchyard API",
    "version": "1",
    "summary": "Many coding agents on one codebase: tasks, plans, warnings, conflict fixing and a merge queue that merges on main through checks.",
    "description": "Every route Switchyard answers for people and agents, rendered from the product's own list of its routes. Send a key as Authorization: Bearer <key>. x-yard names the yard command and x-mcp-tool the MCP tool that do the same; x-browser-only says why only a person in a browser does it, and x-no-way why there is no yard command or MCP tool. Query parameters and request bodies are described at https://switchyard.so/api, and errors at https://switchyard.so/errors."
  },
  "servers": [
    {
      "url": "https://app.switchyard.so"
    }
  ],
  "externalDocs": {
    "description": "The docs, and llms.txt for agents",
    "url": "https://switchyard.so/llms.txt"
  },
  "tags": [
    {
      "name": "The project"
    },
    {
      "name": "Tasks"
    },
    {
      "name": "Review, conflicts and resolutions"
    },
    {
      "name": "Rules and checks"
    },
    {
      "name": "Settings and webhooks"
    },
    {
      "name": "Keys"
    },
    {
      "name": "History, records and numbers"
    },
    {
      "name": "Organizations"
    },
    {
      "name": "Your account"
    },
    {
      "name": "Setting a repository up"
    },
    {
      "name": "The service"
    }
  ],
  "security": [
    {
      "key": []
    }
  ],
  "components": {
    "securitySchemes": {
      "key": {
        "type": "http",
        "scheme": "bearer",
        "description": "A project's admin key, a task key or an agent group key for a project's routes; an organization API key for its projects; or a person's sign-in from yard login --github for the account and organization routes."
      }
    },
    "responses": {
      "Error": {
        "description": "Refused or failed: { error: { code, message, hint } }, with the codes https://switchyard.so/errors lists. A 503 with Retry-After means wait that long; send a write again only when the answer carries X-Switchyard-Not-Applied: 1 (with X-Switchyard-Recorded: 1 as well, it was recorded and a resend answers it as it stands), or X-Switchyard-Outcome-Unknown: 1 (a user-work write that met a fault, not known whether it was recorded) and its hint says a resend is safe.",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "required": [
                "error"
              ],
              "properties": {
                "error": {
                  "type": "object",
                  "required": [
                    "code",
                    "message"
                  ],
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "message": {
                      "type": "string"
                    },
                    "hint": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/v1": {
      "get": {
        "operationId": "getV1",
        "summary": "Which service answers: { service: \"switchyard\" }, for a liveness probe.",
        "tags": [
          "The service"
        ],
        "security": [],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard doctor",
        "x-no-way": "internal: a liveness answer for probes and yard doctor; an MCP session is already connected"
      }
    },
    "/v1/upstream": {
      "get": {
        "operationId": "getV1Upstream",
        "summary": "Whether Switchyard, GitHub and Cloudflare are working: the live indicator's colour and its sentence.",
        "tags": [
          "The service"
        ],
        "security": [],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard status",
        "x-mcp-tool": "yard_status"
      }
    },
    "/v1/projects": {
      "post": {
        "operationId": "postV1Projects",
        "summary": "Create a project, empty, imported from a Git URL or following a GitHub repository; answers the project and its admin key.",
        "tags": [
          "The project"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard init",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "get": {
        "operationId": "getV1Projects",
        "summary": "The projects a signed-in person can see, with their organization and team.",
        "tags": [
          "The project"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project list",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/v1/projects/{project}": {
      "get": {
        "operationId": "getV1ProjectsProject",
        "summary": "The project: its id, name, main branch, remote and the GitHub repository it follows.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project show",
        "x-mcp-tool": "yard_whoami"
      }
    },
    "/v1/projects/{project}/me": {
      "get": {
        "operationId": "getV1ProjectsProjectMe",
        "summary": "Who the key or sign-in is: a person, the project's admin, a task or an agent group key.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard whoami",
        "x-mcp-tool": "yard_whoami"
      }
    },
    "/v1/projects/{project}/creation": {
      "get": {
        "operationId": "getV1ProjectsProjectCreation",
        "summary": "How a project's creation started with Prefer: respond-async goes: creating, ready or failed. yard init waits on its own create and never reads this route; yard api GET /v1/projects/{project}/creation reads it.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "no command: yard init waits on its own create and never reads it; yard api GET /v1/projects/{project}/creation reads it; signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/v1/projects/{project}/status": {
      "get": {
        "operationId": "getV1ProjectsProjectStatus",
        "summary": "The project at a glance: main, every task with its plan, stack, merge queue place and warnings, and what the project is doing; with logs=tail each check's log is its last 4,000 characters.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard status",
        "x-mcp-tool": "yard_status"
      }
    },
    "/v1/projects/{project}/notifications": {
      "get": {
        "operationId": "getV1ProjectsProjectNotifications",
        "summary": "Your open notifications of this project's reviews and tasks (hosted Switchyard), read without marking them seen: for a person signed in, an agent signed in over MCP as its person included; a key reads none, with a sentence saying why.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-mcp-tool": "yard_notifications",
        "x-no-way": "signed-in person: yard notifications reads your notifications of every project with your sign-in (GET /api/me/notifications); this route is the MCP sign-in's read inside one project"
      }
    },
    "/v1/projects/{project}/spending-limit": {
      "get": {
        "operationId": "getV1ProjectsProjectSpendingLimit",
        "summary": "The organization's spending limit as the project reads it: a person in full; an agent (a key, an MCP sign-in, an agent's run of yard) the share used and who can raise it by role, never an amount. A person's own run of yard org limit reads the organization's limit instead (GET /api/orgs/{org}/billing/limit), which an agent's run is refused; yard api GET /v1/projects/{project}/spending-limit reads this route with the project's key.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-mcp-tool": "yard_spending_limit",
        "x-no-way": "no command: a person's yard org limit reads the organization's own limit through GET /api/orgs/{org}/billing/limit; yard api GET /v1/projects/{project}/spending-limit reads this route with the project's key"
      }
    },
    "/v1/projects/{project}/queue-health": {
      "get": {
        "operationId": "getV1ProjectsProjectQueueHealth",
        "summary": "The merge queue's health now: one sentence, at most one thing that needs a person, how long submit to merged takes, how many tasks wait, the share sent back, the machine wait of finished tests, and whether merging is paused, held, frozen or stalled; over the newest 200 decisions of the last 24 hours. A task waiting more than 48 hours may be counted only from its next record. Any key of the project reads it, and every reader gets the same answer.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard queue health",
        "x-mcp-tool": "yard_queue_health"
      }
    },
    "/v1/projects/{project}/insights": {
      "get": {
        "operationId": "getV1ProjectsProjectInsights",
        "summary": "The project's numbers over 1, 7 or 30 days: tasks started, merged and sent back, the time to merge and per agent and model.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard insights",
        "x-mcp-tool": "yard_insights"
      }
    },
    "/v1/projects/{project}/value": {
      "get": {
        "operationId": "getV1ProjectsProjectValue",
        "summary": "What Switchyard did for the project over 1, 7 or 30 days, each number counted from its records: tasks merged and the time to merge, broken changes kept out of main, conflicts fixed by each step, check runs not made, flaky checks caught.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard value",
        "x-mcp-tool": "yard_value"
      }
    },
    "/v1/projects/{project}/settings": {
      "get": {
        "operationId": "getV1ProjectsProjectSettings",
        "summary": "Everything the project is set to: reviews, fixes, who submits, the checks, their network, the rules kept and GitHub.",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings",
        "x-mcp-tool": "yard_settings"
      }
    },
    "/v1/projects/{project}/resolutions": {
      "get": {
        "operationId": "getV1ProjectsProjectResolutions",
        "summary": "The conflict resolutions a person made by hand that the project remembers and reuses.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard resolutions",
        "x-mcp-tool": "yard_resolutions"
      }
    },
    "/v1/projects/{project}/resolutions/{key}": {
      "delete": {
        "operationId": "deleteV1ProjectsProjectResolutionsKey",
        "summary": "Forget a remembered conflict resolution (project admin).",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "key",
            "in": "path",
            "required": true,
            "description": "A remembered resolution's key: 64 hex digits",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard resolutions forget",
        "x-mcp-tool": "yard_resolutions"
      }
    },
    "/v1/projects/{project}/checks/network": {
      "put": {
        "operationId": "putV1ProjectsProjectChecksNetwork",
        "summary": "What the checks may reach on the network: open, registries or off (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set check-network",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/webhooks": {
      "get": {
        "operationId": "getV1ProjectsProjectWebhooks",
        "summary": "The project's webhook endpoints and how their deliveries go, never their secrets (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard webhook list",
        "x-mcp-tool": "yard_webhooks"
      },
      "post": {
        "operationId": "postV1ProjectsProjectWebhooks",
        "summary": "Add a webhook endpoint; its signing secret is shown once, with the result of a test event sent to it (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard webhook add",
        "x-mcp-tool": "yard_webhooks"
      }
    },
    "/v1/projects/{project}/webhooks/{webhook}": {
      "delete": {
        "operationId": "deleteV1ProjectsProjectWebhooksWebhook",
        "summary": "Remove a webhook endpoint and the events waiting for it (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook",
            "in": "path",
            "required": true,
            "description": "A webhook endpoint's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard webhook remove",
        "x-mcp-tool": "yard_webhooks"
      }
    },
    "/v1/projects/{project}/webhooks/{webhook}/test": {
      "post": {
        "operationId": "postV1ProjectsProjectWebhooksWebhookTest",
        "summary": "Send one test event to a webhook endpoint and answer its result; at most 30 an endpoint an hour (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "webhook",
            "in": "path",
            "required": true,
            "description": "A webhook endpoint's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard webhook test",
        "x-mcp-tool": "yard_webhooks"
      }
    },
    "/v1/projects/{project}/conflict-data": {
      "put": {
        "operationId": "putV1ProjectsProjectConflictData",
        "summary": "Whether the project's conflict records may help improve conflict fixing: a person's consent.",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "it is consent to use the project's conflict records: a person gives it in a browser signed in within 15 minutes, never with a key or a yard sign-in; an undo never changes it"
      }
    },
    "/v1/projects/{project}/pause": {
      "put": {
        "operationId": "putV1ProjectsProjectPause",
        "summary": "Pause merging on main, with a reason and an optional end (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard pause",
        "x-mcp-tool": "yard_pause"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectPause",
        "summary": "Resume merging (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard resume",
        "x-mcp-tool": "yard_resume"
      }
    },
    "/v1/projects/{project}/copy-again": {
      "post": {
        "operationId": "postV1ProjectsProjectCopyAgain",
        "summary": "Copy the followed GitHub repository again after a failed first copy (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard copy-again",
        "x-mcp-tool": "yard_copy_again"
      }
    },
    "/v1/projects/{project}/copy-history": {
      "post": {
        "operationId": "postV1ProjectsProjectCopyHistory",
        "summary": "Copy the history behind main again after it was cancelled or failed (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard copy-history",
        "x-mcp-tool": "yard_copy_history"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectCopyHistory",
        "summary": "Cancel the copy of the history behind main (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard copy-history --cancel",
        "x-mcp-tool": "yard_copy_history"
      }
    },
    "/v1/projects/{project}/wake-on-open": {
      "put": {
        "operationId": "putV1ProjectsProjectWakeOnOpen",
        "summary": "Whether opening the project wakes its Git engine (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set wake-on-open",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/allowed-apps": {
      "put": {
        "operationId": "putV1ProjectsProjectAllowedApps",
        "summary": "The apps that write: a pull request one of them pushed or opened is its own writer's, which any one person may approve, as GitHub logins such as renovate[bot]; GitHub Actions never is (project admin; adding one is a person's, in a browser).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set allowed-apps",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/self-approval": {
      "put": {
        "operationId": "putV1ProjectsProjectSelfApproval",
        "summary": "Whether the person whose task it is may approve its protected changes (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set self-approval",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/build-cache": {
      "put": {
        "operationId": "putV1ProjectsProjectBuildCache",
        "summary": "Whether checks keep their package downloads between runs (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set build-cache",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/grouped-merge": {
      "put": {
        "operationId": "putV1ProjectsProjectGroupedMerge",
        "summary": "Whether the engine merges path by path (sampled, checked against the full merge one full rebuild in groupedVerifyEvery, or off), and clearing the latch to the full merge after a check differed (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set grouped-merge",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/incremental-rebuild": {
      "put": {
        "operationId": "putV1ProjectsProjectIncrementalRebuild",
        "summary": "Whether the integration is rebuilt only where tasks moved, and how often that is checked against a full rebuild (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set incremental-rebuild",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/merge-trains": {
      "put": {
        "operationId": "putV1ProjectsProjectMergeTrains",
        "summary": "Whether the merge queue runs separate trains: tasks that touch nothing in common are tested and landed apart, and a train's tested change may land on a main another train moved, checked on main afterwards. Off for every project until the default changes, it has no effect until the merge queue reads it, and it helps only where checks are scoped by paths or sparse checkouts (project admin; where people sign in, turning it on is a person's in a browser, with no control on the settings page yet; Switchyard turns merge trains on for a project on request).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set merge-trains",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/continue-merged": {
      "put": {
        "operationId": "putV1ProjectsProjectContinueMerged",
        "summary": "Whether a push to a merged task that builds on the head it merged at continues the task as a new change, its Git key kept past the merge; on by default, and off revokes the key at the merge and tracks no such push (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set continue-merged",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/checks-while-reviewing": {
      "put": {
        "operationId": "putV1ProjectsProjectChecksWhileReviewing",
        "summary": "Whether a task waiting for review runs its checks while it waits (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set checks-while-reviewing",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/checks-before-submit": {
      "put": {
        "operationId": "putV1ProjectsProjectChecksBeforeSubmit",
        "summary": "Whether a task's checks run ahead of submit once its pushes go quiet (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set checks-before-submit",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/engine-sizing": {
      "put": {
        "operationId": "putV1ProjectsProjectEngineSizing",
        "summary": "Whether the Git engine starts on a larger machine after a run under load, billed at that size, or stays on the size its repository needs; hosted, the organization's choice, an owner's or admin's, and letting it grow only in a browser (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set engine-sizing",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/warm-hour": {
      "put": {
        "operationId": "putV1ProjectsProjectWarmHour",
        "summary": "Whether the Git engine stays warm for an hour after work (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set warm-hour",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/engine/wake": {
      "post": {
        "operationId": "postV1ProjectsProjectEngineWake",
        "summary": "Wake the project's Git engine ahead of work (project admin).",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard engine wake",
        "x-mcp-tool": "yard_wake_engine"
      }
    },
    "/v1/projects/{project}/task-permission": {
      "put": {
        "operationId": "putV1ProjectsProjectTaskPermission",
        "summary": "Who submits a finished task: its agent, or a person (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set who-submits",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/fixes": {
      "put": {
        "operationId": "putV1ProjectsProjectFixes",
        "summary": "Whether conflict fixes merge by themselves or wait for a person's approval (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set fixes",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/rules": {
      "put": {
        "operationId": "putV1ProjectsProjectRules",
        "summary": "Keep the rules and checks in Switchyard as a rules file's text, or stop keeping them (project admin).",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard rules keep",
        "x-mcp-tool": "yard_rules_keep"
      }
    },
    "/v1/projects/{project}/rules/unchecked": {
      "post": {
        "operationId": "postV1ProjectsProjectRulesUnchecked",
        "summary": "Say that paths need no check (project admin).",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard rules unchecked",
        "x-mcp-tool": "yard_unchecked"
      }
    },
    "/v1/projects/{project}/docs-excused": {
      "put": {
        "operationId": "putV1ProjectsProjectDocsExcused",
        "summary": "Whether a change only to documentation merges without a check that reads it (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set docs-excused",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/untested-guard/enforce": {
      "post": {
        "operationId": "postV1ProjectsProjectUntestedGuardEnforce",
        "summary": "Start holding untested changes before the guard's seven days of watching end (project admin).",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard rules enforce",
        "x-mcp-tool": "yard_untested_guard_enforce"
      }
    },
    "/v1/projects/{project}/checks/tried": {
      "get": {
        "operationId": "getV1ProjectsProjectChecksTried",
        "summary": "The one trial of the kept checks on main, and which checks are off.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check tried",
        "x-mcp-tool": "yard_checks_tried"
      }
    },
    "/v1/projects/{project}/checks/logs/{log}": {
      "get": {
        "operationId": "getV1ProjectsProjectChecksLogsLog",
        "summary": "A check's full log as plain text.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "log",
            "in": "path",
            "required": true,
            "description": "A check's full log, as the check carries it in fullLog.id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check log",
        "x-mcp-tool": "yard_check_log"
      }
    },
    "/v1/projects/{project}/checks/{check}/shell": {
      "post": {
        "operationId": "postV1ProjectsProjectChecksCheckShell",
        "summary": "Run a command in a failed check's kept machine.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "check",
            "in": "path",
            "required": true,
            "description": "A check's kept machine, as the check carries it",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check shell",
        "x-mcp-tool": "yard_check_shell"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectChecksCheckShell",
        "summary": "End a failed check's kept machine.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "check",
            "in": "path",
            "required": true,
            "description": "A check's kept machine, as the check carries it",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check shell --done",
        "x-mcp-tool": "yard_check_shell"
      }
    },
    "/v1/projects/{project}/feedback": {
      "post": {
        "operationId": "postV1ProjectsProjectFeedback",
        "summary": "Tell the Switchyard team, once, that an answer confused an agent or cost it a retry.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard feedback",
        "x-mcp-tool": "yard_feedback"
      }
    },
    "/v1/projects/{project}/keep-failed-machines": {
      "put": {
        "operationId": "putV1ProjectsProjectKeepFailedMachines",
        "summary": "Whether a task's failed check keeps its machine for a shell (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set keep-failed-machines",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/checks/off": {
      "put": {
        "operationId": "putV1ProjectsProjectChecksOff",
        "summary": "Turn kept checks off or back on (project admin): yard check off and yard check on.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check off",
        "x-mcp-tool": "yard_checks_off"
      }
    },
    "/v1/projects/{project}/checks/try": {
      "post": {
        "operationId": "postV1ProjectsProjectChecksTry",
        "summary": "Try the kept checks that are off once more on main (project admin).",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard check try",
        "x-mcp-tool": "yard_checks_try"
      }
    },
    "/v1/projects/{project}/reviews": {
      "put": {
        "operationId": "putV1ProjectsProjectReviews",
        "summary": "Turn reviews on or off (project admin).",
        "tags": [
          "Settings and webhooks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard settings set reviews",
        "x-mcp-tool": "yard_setting"
      }
    },
    "/v1/projects/{project}/workspaces": {
      "get": {
        "operationId": "getV1ProjectsProjectWorkspaces",
        "summary": "The active tasks, or the merged and abandoned ones newest first, a page at a time.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard branch list",
        "x-mcp-tool": "yard_finished"
      },
      "post": {
        "operationId": "postV1ProjectsProjectWorkspaces",
        "summary": "Start a task, with its key and Git remote. Where people sign in, a key no person is behind (the raw project admin key, or an agent group key no person made) names no assignee (403).",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard branch new",
        "x-mcp-tool": "yard_workspace_create"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectWorkspaces",
        "summary": "Give up a create by its key (?requestId=), only the key that sent it: abandon the task it made while only its create is on it (never by an agent group key), take it out of the admission line, or make no task of a create on its way; a key never seen is 404, and that key's later create of it makes no task.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: a client that gives up a create it keeps sending (yard, the MCP server) calls it with the create's key itself; no person or agent asks for it; internal: a client that gives up a create it keeps sending (yard, the MCP server) calls it with the create's key itself; no person or agent asks for it"
      }
    },
    "/v1/projects/{project}/workspaces/claim": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesClaim",
        "summary": "An agent group key's MCP session takes its task, or resumes it.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-mcp-tool": "yard_workspace_claim",
        "x-no-way": "internal: it serves the MCP server's yard_workspace_claim only; yard branch new starts a task by the route that creates one"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectWorkspacesClaim",
        "summary": "Give up a claim by its key (?requestId=), as DELETE /workspaces does for a create.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: a client that keeps sending a claim gives it up here with the claim's key; yard sends no claims; internal: a client that keeps sending a claim gives it up here with the claim's key; yard_workspace_claim's withdraw gives up its own claims by the route that gives up a create instead"
      }
    },
    "/v1/projects/{project}/fleets": {
      "post": {
        "operationId": "postV1ProjectsProjectFleets",
        "summary": "Make an agent group key, shown once (project admin). Hosted, a person does it in a browser signed in within 15 minutes, and an organization key made for an agent never does; yard and agents are answered approval_required with the settings page.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group create",
        "x-mcp-tool": "yard_agent_group_create"
      },
      "get": {
        "operationId": "getV1ProjectsProjectFleets",
        "summary": "The project's agent group keys, with the tasks each started (project admin).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group list",
        "x-mcp-tool": "yard_agent_groups"
      }
    },
    "/v1/projects/{project}/admin-key/rotate": {
      "post": {
        "operationId": "postV1ProjectsProjectAdminKeyRotate",
        "summary": "Issue a new admin key; every earlier one stops at once (only a person with admin access to the project in a browser signed in within 15 minutes, never a key, the admin key included, and answers a yard or MCP sign-in approval_required with the project's settings page).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project rotate-admin-key",
        "x-no-way": "signed-in person: a rotation stops every earlier admin key at once; Switchyard takes it only from a person signed in with admin access to the project, never from a key, the admin key itself included, so no MCP tool rotates it"
      }
    },
    "/v1/projects/{project}/fleets/{fleet}/rotate": {
      "post": {
        "operationId": "postV1ProjectsProjectFleetsFleetRotate",
        "summary": "Issue a new secret for an agent group key, the old one working for a grace period (project admin). Hosted, in a browser, as making one.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fleet",
            "in": "path",
            "required": true,
            "description": "An agent group key's id, such as F1",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group",
        "x-mcp-tool": "yard_agent_group_key"
      }
    },
    "/v1/projects/{project}/fleets/{fleet}/disable": {
      "post": {
        "operationId": "postV1ProjectsProjectFleetsFleetDisable",
        "summary": "Stop an agent group key and its tasks' keys without revoking it (project admin).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fleet",
            "in": "path",
            "required": true,
            "description": "An agent group key's id, such as F1",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group",
        "x-mcp-tool": "yard_agent_group_key"
      }
    },
    "/v1/projects/{project}/fleets/{fleet}/enable": {
      "post": {
        "operationId": "postV1ProjectsProjectFleetsFleetEnable",
        "summary": "Start a stopped agent group key again (project admin). Hosted, in a browser, as making one; stopping one stays open to yard.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fleet",
            "in": "path",
            "required": true,
            "description": "An agent group key's id, such as F1",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group",
        "x-mcp-tool": "yard_agent_group_key"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/key": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceKey",
        "summary": "Replace a task's key when it may have leaked. Where people sign in, a key that names no person (the raw project admin key included) is refused with 403: a person signed in, or an organization API key, which carries its maker, replaces it.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard branch key",
        "x-mcp-tool": "yard_task_key"
      }
    },
    "/v1/projects/{project}/fleets/offboard": {
      "post": {
        "operationId": "postV1ProjectsProjectFleetsOffboard",
        "summary": "End or keep a departing member's agent group keys, as their removal from the organization asks (a person signed in with admin access, never a key).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: it runs as part of removing a member from the organization, a person's change to its people; signed-in person: it runs as part of removing a member from the organization, a person's change to its people"
      }
    },
    "/v1/projects/{project}/fleets/{fleet}/revoke": {
      "post": {
        "operationId": "postV1ProjectsProjectFleetsFleetRevoke",
        "summary": "Revoke an agent group key, optionally abandoning its tasks (project admin).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fleet",
            "in": "path",
            "required": true,
            "description": "An agent group key's id, such as F1",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard group",
        "x-mcp-tool": "yard_agent_group_key"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/plan": {
      "put": {
        "operationId": "putV1ProjectsProjectWorkspacesWorkspacePlan",
        "summary": "Set or update a task's plan; answers the warnings about it.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard plan",
        "x-mcp-tool": "yard_plan"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/tags": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceTags",
        "summary": "Set or remove a task's tags.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard tag",
        "x-mcp-tool": "yard_tag"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/warnings": {
      "get": {
        "operationId": "getV1ProjectsProjectWorkspacesWorkspaceWarnings",
        "summary": "What overlaps with a task, each warning with a suggestion.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard warnings",
        "x-mcp-tool": "yard_warnings"
      }
    },
    "/v1/projects/{project}/pulls/{number}": {
      "get": {
        "operationId": "getV1ProjectsProjectPullsNumber",
        "summary": "A pull request of the followed GitHub repository: where it stands in the merge queue, its reason code and sentence, its task and the head it is about (?repository=owner/name, when given, must be the followed one).",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "number",
            "in": "path",
            "required": true,
            "description": "number",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard pr status",
        "x-mcp-tool": "yard_pr_status"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/notice": {
      "get": {
        "operationId": "getV1ProjectsProjectWorkspacesWorkspaceNotice",
        "summary": "Switchyard's note on a task: what it last changed, its place in the merge queue, its conflicts and warnings.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notice",
        "x-mcp-tool": "yard_notice"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/observe": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceObserve",
        "summary": "Read a task's branch now after a push, instead of waiting for the push event.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard commit",
        "x-mcp-tool": "yard_warnings"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/claims": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceClaims",
        "summary": "Say which paths and symbols a task will touch; answers the warnings about them.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard claim",
        "x-mcp-tool": "yard_claim"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/ops": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceOps",
        "summary": "Run an operation on a task: sync, absorb, split, squash, reorder, uncommit, edit, move, tear_off, abandon, assign, priority or agent. yard: sync, absorb, split, squash, move, uncommit, edit, abandon, assign and hotfix; MCP: yard_sync, yard_absorb, yard_split, yard_squash, yard_assign, yard_priority and yard_workspace_op.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard sync",
        "x-mcp-tool": "yard_workspace_op"
      }
    },
    "/v1/projects/{project}/live": {
      "post": {
        "operationId": "postV1ProjectsProjectLive",
        "summary": "A single-use ticket, good for 60 s, for the live WebSocket the board and yard status --watch follow; with { workspace } the socket is told only when that task's status, head or merge queue state moves, as the waits of yard submit --wait use it.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard status --watch",
        "x-no-way": "internal: the live feed is a WebSocket held open for as long as one watches, which an MCP tool call cannot hold; MCP reads the same state with yard_status"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/credentials": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceCredentials",
        "summary": "A fresh Git key for a task's remote. Where people sign in, a key no person is behind (the raw project admin key, or a task key no person holds) gets none for a task a person is behind (403): a person signed in or an agent group key pushes to it.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard branch open",
        "x-mcp-tool": "yard_git_credentials"
      }
    },
    "/v1/projects/{project}/main/credentials": {
      "post": {
        "operationId": "postV1ProjectsProjectMainCredentials",
        "summary": "A read-only Git key for main, for an hour.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard fetch",
        "x-mcp-tool": "yard_git_credentials"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/retry": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceRetry",
        "summary": "Let a task the merge queue holds after its check failed again and again with no cause found go to the merge queue once more (a person on the team only; at most once in ten minutes a task).",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: a person decides that a check's failures with no cause found were not the task's, never an agent, so no MCP tool retries it; yard has no command for it: a person signed in with yard login calls the route with yard api; signed-in person: a person decides that a check's failures with no cause found were not the task's, never an agent, so no MCP tool retries it; yard has no command for it: a person signed in with yard login calls the route with yard api"
      }
    },
    "/v1/projects/{project}/workspaces/{workspace}/submit": {
      "post": {
        "operationId": "postV1ProjectsProjectWorkspacesWorkspaceSubmit",
        "summary": "Submit a task to the merge queue at the head it was pushed to.",
        "tags": [
          "Tasks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "workspace",
            "in": "path",
            "required": true,
            "description": "A task: its number or id, such as 8, W8 or task 8",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard submit",
        "x-mcp-tool": "yard_submit"
      }
    },
    "/v1/projects/{project}/changes/{change}": {
      "get": {
        "operationId": "getV1ProjectsProjectChangesChange",
        "summary": "A change, every version of it and its diff.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "change",
            "in": "path",
            "required": true,
            "description": "A change's Change-Id, or a prefix of it the project knows",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard show",
        "x-mcp-tool": "yard_change"
      }
    },
    "/v1/projects/{project}/changes/{change}/interdiff": {
      "get": {
        "operationId": "getV1ProjectsProjectChangesChangeInterdiff",
        "summary": "What changed between two versions of a change.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "change",
            "in": "path",
            "required": true,
            "description": "A change's Change-Id, or a prefix of it the project knows",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard show",
        "x-mcp-tool": "yard_change"
      }
    },
    "/v1/projects/{project}/conflicts": {
      "get": {
        "operationId": "getV1ProjectsProjectConflicts",
        "summary": "The open conflicts in every task with the conflict steps tried, and those fixed lately.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard conflicts",
        "x-mcp-tool": "yard_conflicts"
      }
    },
    "/v1/projects/{project}/conflicts/{change}/sides": {
      "get": {
        "operationId": "getV1ProjectsProjectConflictsChangeSides",
        "summary": "Each side and the base of one conflicted file, with the commits and plans behind them.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "change",
            "in": "path",
            "required": true,
            "description": "A change's Change-Id, or a prefix of it the project knows",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard conflicts --sides",
        "x-mcp-tool": "yard_conflict_sides"
      }
    },
    "/v1/projects/{project}/conflicts/{change}/resolve": {
      "post": {
        "operationId": "postV1ProjectsProjectConflictsChangeResolve",
        "summary": "Climb the conflict steps for a change, or send a resolution.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "change",
            "in": "path",
            "required": true,
            "description": "A change's Change-Id, or a prefix of it the project knows",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard resolve",
        "x-mcp-tool": "yard_resolve"
      }
    },
    "/v1/projects/{project}/agent-approvals": {
      "get": {
        "operationId": "getV1ProjectsProjectAgentApprovals",
        "summary": "Whether the organization lets an agent signed in as a person approve another person's unprotected change at once, recorded as agent for that person; false when the setting cannot be read. yard org agent-approvals reads the organization's setting instead (GET /api/orgs/{org}/agent-approvals, with a person's sign-in).",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-mcp-tool": "yard_review",
        "x-no-way": "no command: a person's yard org agent-approvals reads the organization's setting through GET /api/orgs/{org}/agent-approvals; yard api GET /v1/projects/{project}/agent-approvals reads this route"
      }
    },
    "/v1/projects/{project}/review/pending/{pending}": {
      "get": {
        "operationId": "getV1ProjectsProjectReviewPendingPending",
        "summary": "Whether an approval waiting for a person's confirmation in a browser was confirmed, declined or expired.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pending",
            "in": "path",
            "required": true,
            "description": "An approval waiting for a person's confirmation",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard review approve --wait",
        "x-browser-only": "an approval of a protected change waits for the same person to confirm it in a browser signed in within 15 minutes, never with a key or a yard sign-in"
      },
      "post": {
        "operationId": "postV1ProjectsProjectReviewPendingPending",
        "summary": "Confirm or decline an approval, from the board's own signed-in page only.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pending",
            "in": "path",
            "required": true,
            "description": "An approval waiting for a person's confirmation",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "an approval of a protected change waits for the same person to confirm it in a browser signed in within 15 minutes, never with a key or a yard sign-in"
      }
    },
    "/v1/projects/{project}/review/{change}/{version}": {
      "post": {
        "operationId": "postV1ProjectsProjectReviewChangeVersion",
        "summary": "Approve a change's version, ask for a fix or comment: yard review approve, yard review request-fix and yard review comment. An approval from yard or an agent signed in as its person answers 202 with status approval_required and a link where the person confirms it in a browser, unless the organization lets agents approve work and the change is another person's and unprotected; then it is recorded as agent for its person.",
        "tags": [
          "Review, conflicts and resolutions"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "change",
            "in": "path",
            "required": true,
            "description": "A change's Change-Id, or a prefix of it the project knows",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "path",
            "required": true,
            "description": "A version number of the change",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard review approve",
        "x-mcp-tool": "yard_review"
      }
    },
    "/v1/projects/{project}/why": {
      "get": {
        "operationId": "getV1ProjectsProjectWhy",
        "summary": "The change, task, agent and plan that last wrote a line.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard why",
        "x-mcp-tool": "yard_why"
      }
    },
    "/v1/projects/{project}/attestations/{commit}": {
      "get": {
        "operationId": "getV1ProjectsProjectAttestationsCommit",
        "summary": "A merged commit's signed merge record, and whether it verifies.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "commit",
            "in": "path",
            "required": true,
            "description": "A merged commit: 7 or more hex digits",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard verify",
        "x-mcp-tool": "yard_attestation"
      }
    },
    "/v1/projects/{project}/signer": {
      "get": {
        "operationId": "getV1ProjectsProjectSigner",
        "summary": "The project's signing key and its allowed_signers line.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard verify --signer",
        "x-mcp-tool": "yard_signer"
      }
    },
    "/v1/projects/{project}/oplog": {
      "get": {
        "operationId": "getV1ProjectsProjectOplog",
        "summary": "The project's history, a page of actions at a time; with logs=tail each check's log is its last 4,000 characters.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard log",
        "x-mcp-tool": "yard_log"
      }
    },
    "/v1/projects/{project}/oplog/{seq}/undo": {
      "post": {
        "operationId": "postV1ProjectsProjectOplogSeqUndo",
        "summary": "Undo an action.",
        "tags": [
          "History, records and numbers"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "seq",
            "in": "path",
            "required": true,
            "description": "An action's sequence number in the project's history",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard undo",
        "x-mcp-tool": "yard_undo"
      }
    },
    "/v1/projects/{project}/mcp": {
      "post": {
        "operationId": "postV1ProjectsProjectMcp",
        "summary": "The MCP server for one project, over streamable HTTP, with a task, admin or agent group key.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: it is the MCP server's own endpoint, which an MCP client calls; yard agent setup writes that client's configuration and calls nothing; internal: it is the MCP server's own endpoint, which every MCP tool goes through"
      },
      "get": {
        "operationId": "getV1ProjectsProjectMcp",
        "summary": "The MCP server's event stream for an open session.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: it is the MCP server's own endpoint, which an MCP client calls; yard agent setup writes that client's configuration and calls nothing; internal: it is the MCP server's own endpoint, which every MCP tool goes through"
      },
      "delete": {
        "operationId": "deleteV1ProjectsProjectMcp",
        "summary": "End an MCP session.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: it is the MCP server's own endpoint, which an MCP client calls; yard agent setup writes that client's configuration and calls nothing; internal: it is the MCP server's own endpoint, which every MCP tool goes through"
      }
    },
    "/v1/openapi.json": {
      "get": {
        "operationId": "getV1OpenapiJson",
        "summary": "This API described in OpenAPI 3.1, rendered from the routes Switchyard answers.",
        "tags": [
          "The service"
        ],
        "security": [],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: it describes the API for machines; yard and the MCP server are two of the ways it describes; internal: it describes the API for machines; yard and the MCP server are two of the ways it describes"
      }
    },
    "/api/auth/device/code": {
      "post": {
        "operationId": "postApiAuthDeviceCode",
        "summary": "Ask for a code to sign yard in, approved by a person in a browser.",
        "tags": [
          "Your account"
        ],
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard login --github",
        "x-no-way": "internal: it is how yard login --github signs in; an MCP client signs in its own way (Claude Code and Codex) or sends a key"
      }
    },
    "/api/auth/device/token": {
      "post": {
        "operationId": "postApiAuthDeviceToken",
        "summary": "Collect yard's sign-in once the person approved its code.",
        "tags": [
          "Your account"
        ],
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard login --github",
        "x-no-way": "internal: it is how yard login --github signs in; an MCP client signs in its own way (Claude Code and Codex) or sends a key"
      }
    },
    "/api/auth/sign-out": {
      "post": {
        "operationId": "postApiAuthSignOut",
        "summary": "Sign out this sign-in; without one it signs nothing out.",
        "tags": [
          "Your account"
        ],
        "security": [],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard logout",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/auth/revoke-sessions": {
      "post": {
        "operationId": "postApiAuthRevokeSessions",
        "summary": "Sign out everywhere you are signed in. A person does it in a browser signed in within 15 minutes; yard is answered approval_required with the account page.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account sessions end --all",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/auth/organization/create": {
      "post": {
        "operationId": "postApiAuthOrganizationCreate",
        "summary": "Make an organization, with the person who makes it as its owner, in a browser where they are signed in (any time ago); a yard or MCP sign-in is answered approval_required with the page, an agent's account is refused, and on open sign-up so is an account whose email is not proven.",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "a person makes an organization in a browser where they are signed in, however long ago, so no agent makes one its person did not ask for; yard org create and an MCP sign-in are answered approval_required with the page"
      }
    },
    "/api/auth/organization/update": {
      "post": {
        "operationId": "postApiAuthOrganizationUpdate",
        "summary": "Rename an organization (owners only).",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org rename",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/auth/organization/delete": {
      "post": {
        "operationId": "postApiAuthOrganizationDelete",
        "summary": "Delete an organization, in a browser signed in within 15 minutes (owners only).",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "it cannot be undone, so an owner does it in a browser signed in within 15 minutes, never with a key or a yard sign-in; yard org delete prints that page"
      }
    },
    "/api/auth/delete-user": {
      "post": {
        "operationId": "postApiAuthDeleteUser",
        "summary": "Delete your account.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "it cannot be undone, so a person does it in a browser signed in within 15 minutes, never with a yard sign-in"
      }
    },
    "/api/auth/organization/accept-invitation": {
      "post": {
        "operationId": "postApiAuthOrganizationAcceptInvitation",
        "summary": "Accept an invitation sent to you.",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org accept",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/auth/organization/reject-invitation": {
      "post": {
        "operationId": "postApiAuthOrganizationRejectInvitation",
        "summary": "Decline an invitation sent to you.",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org decline",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/auth/organization/cancel-invitation": {
      "post": {
        "operationId": "postApiAuthOrganizationCancelInvitation",
        "summary": "Withdraw an open invitation.",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org withdraw",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/me": {
      "get": {
        "operationId": "getApiMe",
        "summary": "Who is signed in, their organizations and teams.",
        "tags": [
          "Your account"
        ],
        "security": [],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard whoami",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/me/emails": {
      "get": {
        "operationId": "getApiMeEmails",
        "summary": "Which kinds of email Switchyard sends you: needs-you, assigned, sent-back, digest and billing.",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account emails",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiMeEmails",
        "summary": "Turn one kind of email on or off.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account emails set",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/me/notifications": {
      "get": {
        "operationId": "getApiMeNotifications",
        "summary": "Your notifications with the switch on: what needs you and what is for your information, each saying why you got it, and the bell's counts (?organization=, its id or its slug, or ?project= puts one organization in view; an organization you are not in is refused).",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/notifications/seen": {
      "post": {
        "operationId": "postApiMeNotificationsSeen",
        "summary": "Mark notifications seen ({ ids }): shown in the open list; the number does not change.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: a browser marks what the bell showed; yard notifications marks nothing seen, and yard notifications read marks rows read; signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/notifications/read": {
      "post": {
        "operationId": "postApiMeNotificationsRead",
        "summary": "Mark notifications read: { ids }, a task's ({ projectId, task }) or a category's ({ category }).",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications read",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/notifications/clear": {
      "post": {
        "operationId": "postApiMeNotificationsClear",
        "summary": "Take notifications out of your list: { ids }, a task's ({ projectId, task }) or all ({ all: true }).",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications clear",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/notifications/mute": {
      "post": {
        "operationId": "postApiMeNotificationsMute",
        "summary": "Mute a task ({ project, task, on: true }) or a whole project ({ project, on: true }) so it makes no notifications that can be turned off; on: false lifts it. An ask of you by name still comes.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications mute",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/notification-settings": {
      "get": {
        "operationId": "getApiMeNotificationSettings",
        "summary": "Your notification settings with the switch on: each category you can receive with its kinds and channels (bell, summary, email), the exceptions for one organization, the daily summary, your mutes, and what is always sent with why.",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications settings",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      },
      "put": {
        "operationId": "putApiMeNotificationSettings",
        "summary": "Change one setting: a category's or a kind's channel on or off ({ category, kind?, channel, on }), for every organization or one ({ organization }; on: null takes that exception away), or the summary ({ summary: { on?, weekends?, timeZone? } }). What is always sent cannot be turned off.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard notifications settings set",
        "x-no-way": "signed-in person: a person's own notifications, read and changed signed in as that person; an agent's MCP sign-in reads only its person's open reviews and tasks of one project, with yard_notifications (GET /v1/projects/{project}/notifications)"
      }
    },
    "/api/me/live": {
      "post": {
        "operationId": "postApiMeLive",
        "summary": "A single-use ticket, good for 60 s, for the live connection that tells the bell its counts changed. An optional { timeZone } (the browser's) sets when the daily summary comes, the first time one is sent.",
        "tags": [
          "Your account"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: the bell's live connection is a WebSocket held open while a page shows the bell, which a yard command or an MCP tool call does not hold; internal: the bell's live connection is a WebSocket held open while a page shows the bell, which a yard command or an MCP tool call does not hold"
      }
    },
    "/api/me/two-factor": {
      "get": {
        "operationId": "getApiMeTwoFactor",
        "summary": "Your two-factor state: whether an authenticator app is set up, whether setup is half done, and which organizations require it.",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "a person confirms it in a browser, signed in with GitHub in the last 15 minutes; no key and no agent confirms it"
      }
    },
    "/api/me/agents": {
      "get": {
        "operationId": "getApiMeAgents",
        "summary": "The agents you signed in over MCP: each client, the organization you approved it for, and when it last got a token.",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account agents",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/me/agents/{agent}": {
      "delete": {
        "operationId": "deleteApiMeAgentsAgent",
        "summary": "End one agent's MCP sign-in at once: its tokens stop working and it cannot refresh them.",
        "tags": [
          "Your account"
        ],
        "parameters": [
          {
            "name": "agent",
            "in": "path",
            "required": true,
            "description": "agent",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account agents end",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/sessions": {
      "get": {
        "operationId": "getApiSessions",
        "summary": "Where you are signed in.",
        "tags": [
          "Your account"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account sessions",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/sessions/{session}": {
      "delete": {
        "operationId": "deleteApiSessionsSession",
        "summary": "Sign one of your sign-ins out.",
        "tags": [
          "Your account"
        ],
        "parameters": [
          {
            "name": "session",
            "in": "path",
            "required": true,
            "description": "A sign-in's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard account sessions end",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/github": {
      "get": {
        "operationId": "getApiGithub",
        "summary": "The Switchyard GitHub App's name and owner.",
        "tags": [
          "Setting a repository up"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "internal: the board reads the App's name here; yard setup github reads it with the installations from /api/onboarding/github; signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/onboarding/github": {
      "get": {
        "operationId": "getApiOnboardingGithub",
        "summary": "The GitHub App, its install link and the installations a signed-in person can use.",
        "tags": [
          "Setting a repository up"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard setup github",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/onboarding/repositories": {
      "get": {
        "operationId": "getApiOnboardingRepositories",
        "summary": "The repositories of one installation of the App, a page at a time or by search.",
        "tags": [
          "Setting a repository up"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard setup repos",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/onboarding/analysis": {
      "get": {
        "operationId": "getApiOnboardingAnalysis",
        "summary": "What setting a repository up would do: the checks drafted from its CI, the rules, its protection and what already exists.",
        "tags": [
          "Setting a repository up"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard setup analyze",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/onboarding/setup": {
      "post": {
        "operationId": "postApiOnboardingSetup",
        "summary": "Set a repository up with a plan: commit the rules and workflow changes, or open a pull request.",
        "tags": [
          "Setting a repository up"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard setup apply",
        "x-no-way": "signed-in person: it answers to a person's own access on GitHub; it stays allowed with the person's yard sign-in, so an agent sets a repository up for its person, but no key or MCP tool does"
      }
    },
    "/api/onboarding/checks-on": {
      "post": {
        "operationId": "postApiOnboardingChecksOn",
        "summary": "Choose where a project's checks run: Switchyard's machines or the repository's own GitHub Actions.",
        "tags": [
          "Setting a repository up"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard setup checks-on",
        "x-no-way": "signed-in person: the change answers to a person's own access on GitHub, which an agent's key does not have"
      }
    },
    "/api/projects/{project}/protected-areas": {
      "get": {
        "operationId": "getApiProjectsProjectProtectedAreas",
        "summary": "The protected areas a GitHub repository has and the project's rules miss.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard rules protect",
        "x-no-way": "signed-in person: the change answers to a person's own access on GitHub, which an agent's key does not have"
      },
      "post": {
        "operationId": "postApiProjectsProjectProtectedAreas",
        "summary": "Add those protected areas to the project's rules.",
        "tags": [
          "Rules and checks"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard rules protect --add",
        "x-no-way": "signed-in person: the change answers to a person's own access on GitHub, which an agent's key does not have"
      }
    },
    "/api/projects/{project}/deletion": {
      "get": {
        "operationId": "getApiProjectsProjectDeletion",
        "summary": "Whether a project's deletion is scheduled, and when.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project deletion",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "post": {
        "operationId": "postApiProjectsProjectDeletion",
        "summary": "Schedule a project's deletion; its data is kept 30 days. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project delete",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "delete": {
        "operationId": "deleteApiProjectsProjectDeletion",
        "summary": "Keep a project whose deletion is scheduled.",
        "tags": [
          "The project"
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "description": "The project's id",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard project keep",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs": {
      "get": {
        "operationId": "getApiOrgs",
        "summary": "Your organizations, with your role and plan.",
        "tags": [
          "Organizations"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org list",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}": {
      "get": {
        "operationId": "getApiOrgsOrg",
        "summary": "One organization: its name, plan, your role and its teams.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org show",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/teams/{org}": {
      "get": {
        "operationId": "getApiTeamsOrg",
        "summary": "One organization, by its older address.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "no command: it is the older address of GET /api/orgs/{org}, which yard org show reads; yard api sends it with a person's sign-in; signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/members": {
      "get": {
        "operationId": "getApiOrgsOrgMembers",
        "summary": "The organization's members and their teams.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org members",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/invitations": {
      "get": {
        "operationId": "getApiOrgsOrgInvitations",
        "summary": "The organization's open invitations.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org invitations",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/invitations": {
      "post": {
        "operationId": "postApiInvitations",
        "summary": "Invite someone to an organization by GitHub login; while a SCIM directory is paired, the answer carries a warning that a person the directory deactivates loses the seat and its role replaces the one given. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org invite",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      },
      "get": {
        "operationId": "getApiInvitations",
        "summary": "The invitations sent to you.",
        "tags": [
          "Organizations"
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org invited",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/members/{member}/keys": {
      "get": {
        "operationId": "getApiOrgsOrgMembersMemberKeys",
        "summary": "The keys that end when a member is removed or changes role, to keep chosen ones for the team.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member",
            "in": "path",
            "required": true,
            "description": "A member of the organization",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org remove --keep",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/members/{member}/role": {
      "post": {
        "operationId": "postApiOrgsOrgMembersMemberRole",
        "summary": "Change a member's role. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member",
            "in": "path",
            "required": true,
            "description": "A member of the organization",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org role",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/members/{member}/remove": {
      "post": {
        "operationId": "postApiOrgsOrgMembersMemberRemove",
        "summary": "Remove a member. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member",
            "in": "path",
            "required": true,
            "description": "A member of the organization",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org remove",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/leave": {
      "post": {
        "operationId": "postApiOrgsOrgLeave",
        "summary": "Leave an organization. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org leave",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/teams": {
      "get": {
        "operationId": "getApiOrgsOrgTeams",
        "summary": "The organization's teams.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org teams",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "post": {
        "operationId": "postApiOrgsOrgTeams",
        "summary": "Make a team, { name, slug } (owners and admins, in a browser signed in within 15 minutes; yard is answered approval_required with the teams page).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org team create",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/teams/{team}": {
      "delete": {
        "operationId": "deleteApiOrgsOrgTeamsTeam",
        "summary": "Remove a team; its projects become the whole organization's. Owners and admins, in a browser signed in within 15 minutes; yard is answered approval_required with the teams page.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "team",
            "in": "path",
            "required": true,
            "description": "A team's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org team delete",
        "x-no-way": "signed-in person: it changes the organization's people, teams or roles, which a person does themselves; no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/teams/{team}/members": {
      "get": {
        "operationId": "getApiOrgsOrgTeamsTeamMembers",
        "summary": "A team's members.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "team",
            "in": "path",
            "required": true,
            "description": "A team's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org members --team",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "post": {
        "operationId": "postApiOrgsOrgTeamsTeamMembers",
        "summary": "Add a member to a team, { userId }. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "team",
            "in": "path",
            "required": true,
            "description": "A team's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "who is on a team decides who reviews what, so a person adds someone to a team or takes them off in a browser signed in within 15 minutes; no key, yard sign-in or agent does it, and yard org team add and remove are answered approval_required with the teams page"
      }
    },
    "/api/orgs/{org}/teams/{team}/members/{member}": {
      "delete": {
        "operationId": "deleteApiOrgsOrgTeamsTeamMembersMember",
        "summary": "Take a member out of a team, by their account's id. In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "team",
            "in": "path",
            "required": true,
            "description": "A team's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "member",
            "in": "path",
            "required": true,
            "description": "A member of the organization",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "who is on a team decides who reviews what, so a person adds someone to a team or takes them off in a browser signed in within 15 minutes; no key, yard sign-in or agent does it, and yard org team add and remove are answered approval_required with the teams page"
      }
    },
    "/api/orgs/{org}/keys": {
      "get": {
        "operationId": "getApiOrgsOrgKeys",
        "summary": "The organization's API keys, never their secrets (owners and admins).",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org keys",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "post": {
        "operationId": "postApiOrgsOrgKeys",
        "summary": "Make an organization API key, shown once (owners and admins). { forAgents: true } marks it as an agent's: it is refused every act a person does in a browser and is held by \"agents may land work\". In a browser signed in within 15 minutes; from yard or an MCP sign-in it answers approval_required with the page where the person does it, and a key is refused.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org key create",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/keys/{key}/{action}": {
      "post": {
        "operationId": "postApiOrgsOrgKeysKeyAction",
        "summary": "Rotate, disable, enable, revoke or keep for the team an organization API key (owners and admins). Rotate, keep and enable are a person's in a browser signed in within 15 minutes, and answer approval_required with the page from yard or an MCP sign-in, and a key is refused; disable and revoke work from yard too, so a leaked key is stopped fast.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "key",
            "in": "path",
            "required": true,
            "description": "A remembered resolution's key: 64 hex digits",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "action",
            "in": "path",
            "required": true,
            "description": "rotate, disable, enable, revoke or keep",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org key",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/ai-fixes": {
      "get": {
        "operationId": "getApiOrgsOrgAiFixes",
        "summary": "Whether AI conflict fixes are on, and how much of their allowance is used.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org ai-fixes",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiOrgsOrgAiFixes",
        "summary": "Turn AI conflict fixes on or off, in a browser signed in within 15 minutes.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "AI fixes spend on the organization's bill, so a person turns them on or off in a browser signed in within 15 minutes; yard org ai-fixes on prints that page"
      }
    },
    "/api/orgs/{org}/agent-approvals": {
      "get": {
        "operationId": "getApiOrgsOrgAgentApprovals",
        "summary": "Whether agents signed in as a person may approve other people's unprotected work (off by default); any member reads it.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org agent-approvals",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiOrgsOrgAgentApprovals",
        "summary": "Let agents approve work, or stop them (owners and admins, in a browser signed in within 15 minutes).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "letting agents approve work is changed only by an owner or admin in a browser signed in within 15 minutes, so no agent turns it on for itself; yard org agent-approvals on prints that page"
      }
    },
    "/api/orgs/{org}/agent-policy": {
      "get": {
        "operationId": "getApiOrgsOrgAgentPolicy",
        "summary": "The organization's agent switches, both on by default: yard and MCP access, and whether agents may land work; any member reads them.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: read on the organization's team page; no yard command reads it yet; signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiOrgsOrgAgentPolicy",
        "summary": "Turn yard and MCP access, or agents landing work, on or off, { agentAccess?, agentsMayLand? } (owners and admins, in a browser signed in within 15 minutes).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "what agents may do in an organization is changed only by an owner or admin in a browser signed in within 15 minutes, so no agent turns its own limits off; yard and MCP sign-ins are answered approval_required with the team page"
      }
    },
    "/api/orgs/{org}/engine-sizing": {
      "get": {
        "operationId": "getApiOrgsOrgEngineSizing",
        "summary": "Whether the organization's Git engines grow to a larger machine under load, billed at that size, or stay small.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org engine-sizing",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiOrgsOrgEngineSizing",
        "summary": "Let the organization's Git engines grow under load, or keep them small (owners and admins). Letting them grow takes a browser signed in within 15 minutes, so yard org engine-sizing grows prints that page; keeping them small works from yard.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org engine-sizing",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/value": {
      "get": {
        "operationId": "getApiOrgsOrgValue",
        "summary": "What Switchyard did for the organization's projects over 1, 7 or 30 days, in total and project by project, each number counted from their records: tasks merged and the time to merge, broken changes kept out of main, conflicts fixed by each step, check runs not made, flaky checks caught. It counts the projects the caller may see; one that does not answer within 5 s is named and left out of the total.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org value",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/usage": {
      "get": {
        "operationId": "getApiOrgsOrgUsage",
        "summary": "The month's usage by meter and project. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org usage",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/billing": {
      "get": {
        "operationId": "getApiOrgsOrgBilling",
        "summary": "A month's bill: its lines, its projects and the forecast. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org billing",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/billing/runs.csv": {
      "get": {
        "operationId": "getApiOrgsOrgBillingRunsCsv",
        "summary": "Every check run billed in a month, as CSV. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org billing --csv",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/billing/contacts": {
      "put": {
        "operationId": "putApiOrgsOrgBillingContacts",
        "summary": "Choose who else gets the organization's billing emails, { extra }: the addresses beside its owners, admins and billing members. In a browser signed in within 15 minutes; yard is answered approval_required with the billing page.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org billing contacts",
        "x-browser-only": "it changes the organization's billing, which a person who looks after billing does on the billing page, in a browser signed in within 15 minutes (yard org billing contacts prints that page); no agent's key or tool may"
      }
    },
    "/api/orgs/{org}/billing/limit": {
      "get": {
        "operationId": "getApiOrgsOrgBillingLimit",
        "summary": "The spending limit, its warning and how much of it is used. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts. An agent reads the share used with GET /v1/projects/{project}/spending-limit.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org limit",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      },
      "put": {
        "operationId": "putApiOrgsOrgBillingLimit",
        "summary": "Set the spending limit and its warning.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "a spending limit is set, raised or removed only on the billing page by a person signed in in a browser in the last 15 minutes, never with a key or a yard sign-in; yard org limit set prints the link that confirms it"
      }
    },
    "/api/orgs/{org}/billing/limit/raise": {
      "post": {
        "operationId": "postApiOrgsOrgBillingLimitRaise",
        "summary": "Raise the spending limit in one click: +$100, +$500, remove it or allow until tomorrow.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-browser-only": "a spending limit is set, raised or removed only on the billing page by a person signed in in a browser in the last 15 minutes, never with a key or a yard sign-in; yard org limit set prints the link that confirms it"
      }
    },
    "/api/orgs/{org}/billing/card": {
      "get": {
        "operationId": "getApiOrgsOrgBillingCard",
        "summary": "The card on file, where the organization's payments stand and when the next charge comes. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org card",
        "x-no-way": "signed-in person: it shows the card and the bill's amounts, which only the people who look after billing read; agents never read the spend, and a payment hold reaches them through yard_status and yard_spending_limit"
      },
      "post": {
        "operationId": "postApiOrgsOrgBillingCard",
        "summary": "Open Stripe Checkout for the card: the first card pays the plan's minimum for the rest of the month up front ({ plan?: launch or scale }), counted toward the month's usage; a card change is checked there and nothing is charged.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org card add",
        "x-no-way": "signed-in person: a person who looks after billing enters the card on Stripe's own page; no key opens it, yard is answered approval_required with the billing page, and the MCP server works inside one project with that project's keys"
      }
    },
    "/api/orgs/{org}/billing/invoices": {
      "get": {
        "operationId": "getApiOrgsOrgBillingInvoices",
        "summary": "The organization's statements and their invoices: what was charged, when, and what waits for review. A person reads it; an agent (an MCP sign-in, an agent's run of yard) is refused it, as agents never read money amounts.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org invoices",
        "x-no-way": "signed-in person: it shows the card and the bill's amounts, which only the people who look after billing read; agents never read the spend, and a payment hold reaches them through yard_status and yard_spending_limit"
      }
    },
    "/api/orgs/{org}/billing/limit/offer": {
      "get": {
        "operationId": "getApiOrgsOrgBillingLimitOffer",
        "summary": "What a billing email's raise link offers, for the page it opens.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: it reads what a billing email's raise link offers, for the billing page, where the raise itself takes a browser; signed-in person: it reads what a billing email's raise link offers, for the billing page, where the raise itself takes a browser"
      }
    },
    "/api/orgs/{org}/audit": {
      "get": {
        "operationId": "getApiOrgsOrgAudit",
        "summary": "The organization's audit log by kind, person, outcome and dates, or exported as CSV or JSON lines.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org audit",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/deleted-projects": {
      "get": {
        "operationId": "getApiOrgsOrgDeletedProjects",
        "summary": "The projects the organization deleted lately, who asked, and until when their data is kept.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org deleted",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/sso": {
      "get": {
        "operationId": "getApiOrgsOrgSso",
        "summary": "An organization's single sign-on: its connections, whether SSO is required, and the DNS records still to add (owners see the records).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org sso",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/sso/{provider}/verify": {
      "post": {
        "operationId": "postApiOrgsOrgSsoProviderVerify",
        "summary": "Check the connection's DNS records now; its domains are verified once every record is found (an owner).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "provider",
            "in": "path",
            "required": true,
            "description": "provider",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            }
          }
        },
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org sso verify",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/scim": {
      "get": {
        "operationId": "getApiOrgsOrgScim",
        "summary": "An organization's SCIM directory: whether one is paired, with which single sign-on connection, where the identity provider reaches it and how many people it holds; never the token.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org scim",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/ip-allowlist": {
      "get": {
        "operationId": "getApiOrgsOrgIpAllowlist",
        "summary": "The organization's IP allowlist: the addresses and ranges its members may reach it from (empty: anywhere), and whether this request's address is in it.",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-no-way": "signed-in person: a member with access to it reads it with their own sign-in, which yard holds; yard has no command for it, and yard api sends it with that sign-in; signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    },
    "/api/orgs/{org}/two-factor": {
      "get": {
        "operationId": "getApiOrgsOrgTwoFactor",
        "summary": "The organization's two-factor level (recommended or required), and how members are covered (owners and admins see the counts).",
        "tags": [
          "Organizations"
        ],
        "parameters": [
          {
            "name": "org",
            "in": "path",
            "required": true,
            "description": "An organization's slug",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "2XX": {
            "description": "Done; the answer is JSON, and a project's answers carry seq, its place in the project's history.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "default": {
            "$ref": "#/components/responses/Error"
          }
        },
        "x-yard": "yard org two-factor",
        "x-no-way": "signed-in person: it acts for a person signed in, across projects; the MCP server answers inside one project, even for an agent signed in as its person over OAuth, so organization and account actions are not tools there"
      }
    }
  }
}
