Get a task (with steps)
Authorizations
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
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
Task id.
Response
The task
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.
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.
- search / search_cc / search_rag / work
- curate
- Connector import
- Public-repo import
- Archive upload
- pack
- restore
- explore
- profile
- optimize
- groom
Populated only on GET /tasks/{id}
Set for query turns
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.
- search / search_rag completed
- search_cc completed
- search failed
- Option 4
- restore
- optimize result
- optimize no-op
- groom
- curate run
- curate manifest_tune
- curate no-op
- explore
- profile estimate
- profile empty
- import
- status-keyed failure
- state-keyed failure
- Other
Coarse task progress surfaced to the console.