Upload a source file or archive
One file per request, max 2 GiB. Archives (.zip, .tar, .tar.gz, .tgz) are expanded by the import runtime. Stages the source only — it does not index anything. Curate explicitly with POST /contexts/{slug}/curate before querying.
Authorizations
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
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
Context slug or UUID.
Query Parameters
Subdirectory under the source tree
Body
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.