Docs
API ReferenceReferenceKnowledgebases

File a document in a folder

POST
/knowledgebases/{knowledgebaseId}/sources/{sourceId}/move

Files a document (source) in a folder or page of its knowledgebase, or back on the knowledgebase Home with parentPageId: null. The pages list and the outline show it there, beside the pages it belongs with. A document lives in one place across the organization, so filing it here moves it out of a folder in another knowledgebase. Structural only: content and index are untouched and nothing waits for review. A document or folder outside the knowledgebase is not_found. 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
sourceId*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

curl -X POST "https://example.com/knowledgebases/497f6eca-6276-4993-bfeb-53cbbbba6f08/sources/497f6eca-6276-4993-bfeb-53cbbbba6f08/move" \  -H "Content-Type: application/json" \  -d '{    "parentPageId": "3b2da02d-bb1b-462e-a4ca-3235cd1dd440"  }'
{  "source": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "type": "string",    "status": "string",    "searchable": true,    "disabled": true,    "url": "string",    "updatedAt": "2019-08-24T14:15:22Z",    "createdAt": "2019-08-24T14:15:22Z",    "sizeBytes": 0,    "errorMessage": "string",    "createdVia": "string",    "parentPageId": "3b2da02d-bb1b-462e-a4ca-3235cd1dd440"  }}