Skip to main content
POST
Import source documents from a project connector

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
connector_id
string
required
folder
string

Connector folder id to import

files
string[]

Connector file ids to import

item_type
string
default:folder
path
string

Subdirectory under the source tree (default uploads)

Response

Import accepted (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