Skip to main content

On this pageOverview

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 without indexing it — curate explicitly before querying.

POST /contexts/{slug}/import/upload

Parameters

slug (path, string, required) — Context slug or UUID.
path (query, string) — Subdirectory under the source tree
X-Pinecone-Api-Version (header, string) — 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.

Responses

200 — Upload accepted; import enqueued (state: importing)
400 — Missing/unsafe file name, or archives disallowed in preview
404 — Not found
409 — Context is optimizing, an import is in flight, or the preview file cap was hit (preview_file_limit)
413 — File exceeds 2 GiB, or the preview byte cap was hit (preview_byte_limit)

Suggest an edit