Docs
API ReferenceReferenceKnowledgebases

Append to a page

POST
/knowledgebases/{knowledgebaseId}/pages/{pageId}/append

Adds markdown to the end of the page after a blank line. Nothing already on the page is changed or removed; to edit existing text use PATCH on the page. There is no delete over the API. When the organization reviews agent writes, the response is 202 with status: "pending_review" and the live page is untouched until approved. Requires the knowledge:write scope; a personal key also needs the member role or above.

AuthorizationBearer <token>

An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).

In: header

Path Parameters

knowledgebaseId*string
Formatuuid
pageId*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/knowledgebases/497f6eca-6276-4993-bfeb-53cbbbba6f08/pages/497f6eca-6276-4993-bfeb-53cbbbba6f08/append" \  -H "Content-Type: application/json" \  -d '{    "markdown": "string"  }'
{  "status": "applied",  "page": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "knowledgebaseId": "2eaa043e-18a5-42f0-bbe8-1ad77d6f870c",    "title": "string",    "updatedAt": "2019-08-24T14:15:22Z"  },  "revisionId": "bae12d01-48af-47b3-9304-b09ef0081cd6",  "reviewPath": "string",  "links": {    "pages": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "title": "string"      }    ],    "sources": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string"      }    ],    "unresolved": [      {        "kind": "page",        "id": "string"      }    ]  }}