Skip to main content
DELETE
Cancel/terminate a task

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

Task id.

Body

application/json
reason
string
target
string
pushed
boolean

Set by a self-terminating runtime that already pushed its outputs; tells the orchestrator it may skip the exec pull.

pinecone_api_key
string
user_token
string

Response

Termination enqueued (empty body)