---
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.

---

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