Skip to main content
GET
Get a task (with steps)

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.

Response

The task

id
string
required
project_id
string
required
created_by
string
required
workflow
string
required

The canonical workflow name. Legacy aliases (build, query, query_search, query_sac, query_cc, query_rag, response, agent, session) are still accepted on input and normalized to the canonical value.

state
string
required
input
search / search_cc / search_rag / work · object
required

A task's per-workflow input, written once at creation and echoed back verbatim. It carries no discriminant of its own — the sibling workflow field selects the shape.

steps
object[]
required

Populated only on GET /tasks/{id}

tokens_prompt
integer<int64>
required
tokens_completion
integer<int64>
required
runtime_seconds
integer<int64>
required
created_at
string<date-time>
required
context_id
string | null
agent_id
string | null
session_id
string | null

Set for query turns

error
string | null
output
search / search_rag completed · object

A task's reported output — heterogeneous: every workflow reports a different per-state shape, stored and echoed verbatim. An unrecognized or newer shape is preserved as-is rather than rejected, so treat this union as open.

running_from
string<date-time> | null
timeout_seconds
integer | null
timeout_at
string<date-time> | null
archived_at
string<date-time> | null
last_activity_at
string<date-time> | null
schedule
string | null
scheduled_at
string<date-time> | null
parent_task_id
string | null
progress
object

Coarse task progress surfaced to the console.