Create a page
Creates a page in the knowledgebase: durable, structured notes that the organization's agents read on later runs (meeting notes, client profiles, SOPs, run logs, research). Check the page index first and append to an existing page rather than creating a duplicate. When the organization reviews agent writes, the response is 202 with status: "pending_review" and the page stays empty until a human approves it; otherwise 201 and the page is live. A personal key is recorded as the page's author; an organization key writes unattributed. Requires the knowledge:write scope; a personal key also needs the member role or above.
Authorization
apiKey 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
uuidRequest 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" \ -H "Content-Type: application/json" \ -d '{ "title": "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" } ] }}