Skip to main content
GET
Get a session with its queries (conversation order)

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

id
string
required

Response

The session fields plus a queries array of query turns

A project-owned conversation thread of queries.

id
string
required

ses_

project_id
string
required
created_by
string
required
scope
string[]
required

Pinned context UUIDs (1–10)

models
string[]
required

Pinned model fallback list

tools
string[]
required
created_at
string<date-time>
required
updated_at
string<date-time>
required
queries
object[]
required
workspace
string

Present only on a workspace-enabled cluster

title
string | null
system_prompt
string | null
guardrails
string | null
workflow
string | null

The workflow this session's turns run

last_query_id
string | null