Skip to main content
POST
Run the Design-flow explore agent (propose a manifest)

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

slug
string
required

Context slug or UUID.

Body

application/json
guide
string

High-level guidance to steer the proposal

pinecone_api_key
string

Task-token override; normally not needed

Response

Explore enqueued (state: exploring)

The uniform acknowledgment every context-workflow trigger returns. state is the forward-looking status; the per-workflow boolean flags are legacy and set only for the workflows that historically emitted them.

task_id
string
required
state
string
required
exploring
boolean

Legacy flag; present only for explore

profiling
boolean

Legacy flag; present only for profile

importing
boolean

Legacy flag; present only for the import/curate triggers