Skip to main content
POST
Cancel an in-progress query turn

Authorizations

Authorization
string
header
required

Session token from POST /auth/login. Pass as Authorization: Bearer <token>. The alternative X-Pinecone-Api-Key header is also accepted for direct-key auth (used by the Nexus CLI on first contact).

Headers

X-Pinecone-Api-Version
string
default:2026-07

Date-based contract version. Omit to resolve to the Nexus default version (2026-07, the oldest served version); send unstable for the in-development surface. The resolved version is echoed back on the same header. A present-but-unrecognized value is rejected with 400 unsupported_api_version.

Path Parameters

id
string
required

Response

The (now cancelled) query

One query turn. Read the answer from output[].content[].text.

id
string
required
object
string
required
session_id
string
required
created
integer<int64>
required

Unix seconds

status
string
required
input
object[]
required

The stored message array (plain-text content).

output
object[]
required

Output items; assistant text is {role, content:[{type: output_text, text}]}

citations
object[]
required
steps
object[]
required
usage
object
required
runtime_ms
integer<int64>
required
model
string | null
error
string | null
previous_query_id
string | null
comparison
object[] | null
feedback
object | null
output_json
object | null

Present when a shape was used, or on a retrieval-only turn

rollup
object | null

Per-turn token/cache totals + tool tally (response.turn_rollup)

synthesis
object | null

Token/latency of the answer completion (response.synthesis)

trace_ref
string | null

Blob key of the persisted trace