---
title: "Continue search"
method: POST
path: "/v1/namespaces/{namespace}/search/{session_id}"
tags: ["Search"]
---

# Continue search

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

Continues a multi-turn search session. Use this to respond to clarification questions or provide follow-up messages.

Supports the same `stream` parameter and event types as the search endpoint; see `SearchStreamEvent`.

## Request body

- SearchContinuationRequest
  - `message` string, required — Follow-up message or answer to a clarification question.
  - `stream` boolean — Whether to stream the response as server-sent events.
  - `include_attributes` boolean — Whether to include document attributes in search results.

## Response `200`

Successful response.

- SearchResponse
  - `session_id` string, required — Unique identifier for this search session.
  - `status` 'completed' | 'clarification_needed' | 'failed', required
  - `documents_scanned` integer — Number of documents scanned during the search.
  - `queries_executed` integer — Number of queries executed during the search.
  - `synthesis` string, required — Synthesized summary of all findings.
  - `results` SearchResult[], required
    - `finding` string, required
    - `id` string, required — Source document ID.
    - `excerpts` string[], required
    - `attributes` object — Document attributes. Present when `include_attributes` is `true`.
  - `clarification_needed` object — Present when status is `clarification_needed`.
    - `question` string — The clarification question.
    - `options` string[] — Suggested answer options.

## Other responses

- `400` — The request was invalid.
- `401` — Missing or invalid API key.
- `404` — The requested resource was not found.

## 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` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/charcoalhq/apis/charcoal-api/changes/v1/namespaces/:namespace/search/:session_id/post.md)

---

[API](https://skmtc.dev/charcoalhq/apis/charcoal-api.md) · [All operations](https://skmtc.dev/charcoalhq/apis/charcoal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/charcoalhq/charcoal-api/revisions/eee9850f4746/schema)