---
title: "Changes to Search"
method: POST
path: "/v1/namespaces/{namespace}/search"
---

# Changes to Search

`POST /v1/namespaces/{namespace}/search`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 5 of 8 revisions.

- **2026-04-15** `eee9850f4746` — 1 breaking, 1 info
- **2026-04-13** `5fb72cb4fbca` — 1 info
- **2026-04-13** `6cb1ae65bb78` — 5 breaking, 4 info
- **2026-04-13** `ee3554910b7d` — 13 info
- **2026-04-02** `e67f3d38f850` — 2 breaking, 3 warning

## Changes

- **2026-04-15** `eee9850f4746` — 1 breaking, 1 info
  - added `#/components/schemas/SearchStatusEvent, #/components/schemas/SearchSessionResultEvent, #/components/schemas/SearchErrorEvent` to the response body `oneOf` list for the response status `200`
  - added response discriminator for the response status `200`
- **2026-04-13** `5fb72cb4fbca` — 1 info
  - the response property `session_id` became required for the status `200`
- **2026-04-13** `6cb1ae65bb78` — 5 breaking, 4 info
  - added the new required request property `context`
  - added the new required request property `objective`
  - removed `#/components/schemas/SearchNewSessionRequest, #/components/schemas/SearchContinuationRequest` from the request body `oneOf` list
  - the request's body type/format changed from ``/`` to `object`/``
  - the response property `session_id` became optional for the status `200`
  - added the new optional request property `filters`
  - added the new optional request property `include_attributes`
  - added the new optional request property `multiturn`
  - added the new optional request property `stream`
- **2026-04-13** `ee3554910b7d` — 13 info
  - added the new optional request property `oneOf[subschema #1: New Session]/include_attributes`
  - added the new optional request property `oneOf[subschema #2: Continue Session]/include_attributes`
  - added `subschema #12: Glob, subschema #13: Case-Insensitive Glob` to the `oneOf[subschema #1: New Session]/filters/oneOf[subschema #3: Field Condition]/additionalProperties/` request property `oneOf` list
  - added the media type `text/event-stream` for the response with the status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
  - added the optional property `documents_scanned` to the response with the `200` status
  - added the optional property `queries_executed` to the response with the `200` status
  - added the optional property `results/items/attributes` to the response with the `200` status
  - removed the `expired` enum value from the `status` response property for the response status `200`
  - removed the `pending` enum value from the `status` response property for the response status `200`
  - removed the `running` enum value from the `status` response property for the response status `200`
- **2026-04-02** `e67f3d38f850` — 2 breaking, 3 warning
  - added the new required request property `oneOf[subschema #1: New Session]/context`
  - added the new required request property `oneOf[subschema #1: New Session]/objective`
  - removed the request property `oneOf[subschema #1: New Session]/high_level_goal`
  - removed the request property `oneOf[subschema #1: New Session]/max_results`
  - removed the request property `oneOf[subschema #1: New Session]/search_query`

---

[Operation](https://skmtc.dev/charcoalhq/apis/charcoal-api/docs/v1/namespaces/:namespace/search/post.md) · [API](https://skmtc.dev/charcoalhq/apis/charcoal-api.md) · [Page](https://skmtc.dev/charcoalhq/apis/charcoal-api/changes/v1/namespaces/:namespace/search/post)