Skip to main content
post/datasets/{dataset_id}/documents/{document_id}/segments
Request example
Response
post/datasets/{dataset_id}/documents/{document_id}/segments

Authorization

Authorizationstringheaderrequired#

Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).

Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).

Path parameters

dataset_idstringrequired#
Knowledge base ID, from List Knowledge Bases. For a scoped key, copy the ID from the Dify URL.
document_idstringrequired#
Document ID. Obtain it from List Documents.

Body

application/json
segmentsobject[]required#
Array of chunk objects to create.

Items: min 1

Responses

application/json
Chunks created successfully.
dataobject[]#
List of created chunks.
doc_formstring#
Document chunking mode used by this document.