---
title: "Changes to Semantic Chunker"
method: POST
path: "/v1/chunk/semantic"
---

# Changes to Semantic Chunker

`POST /v1/chunk/semantic`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 20 revisions.

- **2025-04-27** `bc64e1775952` — 1 info
- **2025-04-27** `5c8e44804806` — 1 breaking
- **2025-04-27** `1762a3ecb81b` — 3 info
- **2025-04-27** `7e3cb743a9ed` — 1 warning
- **2025-04-22** `b5fe83cf70c6` — 1 breaking, 1 info
- **2025-04-06** `502b267e607d` — 1 breaking, 2 info
- **2025-04-06** `2d174e4e5a5a` — 1 info
- **2025-04-06** `a9d5b6b90675` — 9 breaking, 1 warning, 11 info
- **2025-04-06** `678e90630336` — 4 info
- **2025-04-06** `c791be50601b` — 2 breaking, 12 warning, 3 info

## Changes

- **2025-04-27** `bc64e1775952` — 1 info
  - endpoint added
- **2025-04-27** `5c8e44804806` — 1 breaking
  - api removed without deprecation
- **2025-04-27** `1762a3ecb81b` — 3 info
  - the `delim` request property default value changed from ` , ., !, ?` to `., !, ?, `
  - the `min_characters_per_sentence` request property default value changed from `1` to `12`
  - the `min_chunk_size` request property default value `2` was removed
- **2025-04-27** `7e3cb743a9ed` — 1 warning
  - removed the request property `text`
- **2025-04-22** `b5fe83cf70c6` — 1 breaking, 1 info
  - removed the media type `application/json` from the request body
  - added the media type `multipart/form-data` to the request body
- **2025-04-06** `502b267e607d` — 1 breaking, 2 info
  - request property `return_type` was restricted to a list of enum values
  - added the new `chunks` enum value to the request property `return_type`
  - added the new `texts` enum value to the request property `return_type`
- **2025-04-06** `2d174e4e5a5a` — 1 info
  - the request property `chunk_size` became optional
- **2025-04-06** `a9d5b6b90675` — 9 breaking, 1 warning, 11 info
  - the response property `items/end_index` became optional for the status `200`
  - the response property `items/sentences` became optional for the status `200`
  - the response property `items/sentences/items/end_index` became optional for the status `200`
  - the response property `items/sentences/items/start_index` became optional for the status `200`
  - the response property `items/sentences/items/text` became optional for the status `200`
  - the response property `items/sentences/items/token_count` became optional for the status `200`
  - the response property `items/start_index` became optional for the status `200`
  - the response property `items/text` became optional for the status `200`
  - the response property `items/token_count` became optional for the status `200`
  - removed the request property `args`
  - added the new optional request property `delim`
  - added the new optional request property `embedding_model`
  - added the new optional request property `include_delim`
  - added the new optional request property `min_characters_per_sentence`
  - added the new optional request property `min_chunk_size`
  - added the new optional request property `min_sentences`
  - added the new optional request property `return_type`
  - added the new optional request property `similarity_window`
  - added the new optional request property `threshold`
  - added the new optional request property `threshold_step`
  - added the new required request property `chunk_size` with a default value
- **2025-04-06** `678e90630336` — 4 info
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `500`
  - added the required property `items/sentences` to the response with the `200` status
- **2025-04-06** `c791be50601b` — 2 breaking, 12 warning, 3 info
  - added the new required request property `args`
  - the response's body type/format changed from ``/`` to `array`/`` for status `200`
  - deleted the `header` request parameter `authorization`
  - removed the request property `chunk_size`
  - removed the request property `delim`
  - removed the request property `embedding_model`
  - removed the request property `include_delim`
  - removed the request property `min_characters_per_sentence`
  - removed the request property `min_chunk_size`
  - removed the request property `min_sentences`
  - removed the request property `return_type`
  - removed the request property `similarity_window`
  - removed the request property `threshold`
  - removed the request property `threshold_step`
  - removed `#/components/schemas/ErrorRES, subschema #1, subschema #2, subschema #3, subschema #4` from the response body `anyOf` list for the response status `200`
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`

---

[Operation](https://skmtc.dev/feyninc/apis/chonkie-api/docs/v1/chunk/semantic/post.md) · [API](https://skmtc.dev/feyninc/apis/chonkie-api.md) · [Page](https://skmtc.dev/feyninc/apis/chonkie-api/changes/v1/chunk/semantic/post)
