Skip to main content
POST
Build or rebuild the context's index from its sources

Authorizations

Authorization
string
header
required

Session token from POST /auth/login, sent as Authorization: Bearer <token>.

Headers

X-Pinecone-Api-Version
string
default:2026-07

Date-based contract version, echoed back on the same header. Omit for the default (2026-07); send unstable for the in-development surface. An unrecognized value is rejected with 400 unsupported_api_version.

Path Parameters

slug
string
required

Context slug or UUID.

Body

application/json

Optional overrides for the run. {} is a valid incremental curate.

force
boolean
default:false

Full rebuild rather than incremental

batch_size
integer

How many sources curate reads per pass.

scope
string

Curate scope recorded on the task input

trigger
string

Provenance label recorded on the task input

model
string

Model-id override for the curate runtime

pinecone_api_key
string

Task-token override; normally not needed

Response

Curate enqueued (state: importing)

What every context-workflow trigger returns. The work is asynchronous: poll GET /tasks/{task_id}. The per-workflow booleans duplicate state and appear only where a workflow's contract names one.

task_id
string
required

The enqueued task. Poll it at GET /tasks/{id}.

state
string
required

The forward-looking status the trigger put the context into.

exploring
boolean

Duplicates state; present only for explore

profiling
boolean

Duplicates state; present only for profile

importing
boolean

Duplicates state; present only for the import/curate triggers