Skip to main content
GET
List tasks (project-wide, paginated)

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.

Query Parameters

workflow
string

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
context
string

Context slug or UUID

q
string

Free-text over id/created_by/input

limit
integer
default:30
Required range: 1 <= x <= 1000
page
integer
default:1
offset
integer

Response

200 - application/json

Paginated tasks

items
object[]
required
total
integer<int64>
required
limit
integer<int64>
required
offset
integer<int64>
required
page
integer<int64>
required
pages
integer<int64>
required