---
title: "Update Chunking Override"
method: PATCH
path: "/v1/convai/knowledge-base/{documentation_id}/chunking-override"
tags: ["Agents Platform"]
---

# Update Chunking Override

`PATCH /v1/convai/knowledge-base/{documentation_id}/chunking-override`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/convai/knowledge-base/{documentation_id}/chunking-override`
- Auth: none declared

Set or clear the RAG chunking override for a document or folder.

## Path parameters

- `documentation_id` string, required: The id of a document from the knowledge base. This is returned on document addition.

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Request body

- UpdateDocumentChunkingOverrideRequestModel
  - `chunking_override` ChunkingOverrideRequestModel, required
    - `max_chunk_size` integer, nullable: Maximum chunk size in tokens. Null inherits from ancestors or the embedding model default.
    - `overlap_percentage` integer, nullable: Chunk overlap as a percentage of the final chunk size, applied after the chunk size is clamped to the embedding model. Null inherits from ancestors or the embedding model default.
    - `custom_separators` string[], nullable: Custom text separators used when splitting. Null inherits from ancestors; an empty list clears inherited separators.

## Response `200`

Successful Response

- UpdateDocumentChunkingOverrideResponseModel
  - `id` string, required: ID of the document or folder whose chunking override was updated.
  - `chunking_override` ChunkingOverride, required
    - `max_chunk_size` integer, nullable, required: Maximum chunk size in tokens. Null uses the inherited value.
    - `overlap_percentage` integer, nullable, required: Chunk overlap as a percentage of the chunk size. Null uses the inherited value.
    - `custom_separators` string[], nullable, required: Custom text separators used when splitting. Null uses the inherited value.
  - `reindex_queued` boolean, required: Whether the effective configuration changed and background reindexing was queued.

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-12** `bb531da5449d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/convai/knowledge-base/:documentation_id/chunking-override/patch.md)

---

[API](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation.md) - [All operations](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/revisions/defd23ab2aa6?raw)