Skip to main content
GET
List contexts (newest first, with stats)

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.

Response

200 - application/json

Contexts visible to the caller in the active project

id
string
required
slug
string
required
name
string
required
kind
string
default:search
required

search — built from source documents; must be curated before it can be queried. work — built from traces of work done; queryable immediately and consolidated by groom rather than curate.

created_by
string
required
description
string | null
required
is_optimizing
boolean
required
has_sources
boolean
required
is_curating
boolean
required
is_importing
boolean
required
is_exploring
boolean
required
is_restoring
boolean
required
is_grooming
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
workspace
string

Present only on a workspace-enabled cluster

guide
string

High-level guidance for the query runtime

manifest
object

Pinned manifest document; absent when the context is on defaults

optimize_task_id
string | null
optimize_score
number<double> | null
optimize_iterations
integer | null
last_optimized_at
string<date-time> | null
last_curated_at
string<date-time> | null
last_source_import_at
string<date-time> | null
curate_task_id
string | null
import_task_id
string | null
explore_task_id
string | null
restore_task_id
string | null
manifest_suggestion
object

Outcome of a Design-flow explore run, pinned to the context row.

sample_queries
string[]

Example questions the curated corpus can answer

groom_task_id
string
groom_artifact_count
integer<int64>
last_groomed_at
string<date-time>
stats
object

Populated only on the list endpoint