Update Docs agent instructions for an organization

Available in MCP

put

Authorizations

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

organizationIdstringRequired

A unique entity identifier

Pattern: ^[a-zA-Z0-9_-]+$

Body

Responses

200

Updated instructions

application/json

objectstring · enumRequiredPossible values:

updatedAtstring · date-timeRequired

updatedBystringRequired

Identifier of the member who last updated the instructions.

put/orgs/{organizationId}/agent-instructions

PUT /v1/orgs/{organizationId}/agent-instructions HTTP/1.1
Host: api.gitbook.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 195

{
  "instructions": {
    "object": "document",
    "data": {},
    "nodes": [
      {
        "object": "block",
        "type": "paragraph",
        "data": {},
        "nodes": [
          {
            "object": "text",
            "leaves": [
              {
                "object": "leaf",
                "text": "Hello world",
                "marks": []
              }
            ]
          }
        ]
      }
    ]
  }
}

200

Updated instructions

{
  "object": "agent-instructions",
  "instructions": {
    "object": "document",
    "data": {},
    "nodes": [
      {
        "object": "block",
        "type": "paragraph",
        "data": {},
        "nodes": [
          {
            "object": "text",
            "leaves": [
              {
                "object": "leaf",
                "text": "Hello world",
                "marks": []
              }
            ]
          }
        ]
      }
    ]
  },
  "updatedAt": "2026-01-01T00:00:00.000Z",
  "updatedBy": "text",
  "urls": {
    "location": "text"
  }
}