Skip to main content
POST
Exchange a Pinecone API key for a session token

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.

Body

application/json
api_key
string

Pinecone API key. Optional — when absent, the server falls back to its configured key (managed) or validates the seeded credential (BYOC).

Response

Session token + identity

token
string
required
principal
string
required
project_id
string
required
project_name
string
required