Skip to main content
POST
Upload a source file or archive

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.

Query Parameters

path
string
default:uploads

Subdirectory under the source tree

Body

multipart/form-data
file
file
required

Response

Upload accepted; import enqueued (state: importing)

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