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"
  }
}

Last updated

Was this helpful?

Powered by GitBook