Get a session with its queries (conversation order)

One session with its turns in conversation order.

GET /sessions/{id}

Get a session with its queries (conversation order)

cURL

curl --request GET \
  --url https://{host}/api/sessions/{id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "project_id": "<string>",
  "created_by": "<string>",
  "scope": [
    "<string>"
  ],
  "models": [
    "<string>"
  ],
  "tools": [
    "<string>"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "queries": [
    {
      "id": "<string>",
      "object": "<string>",
      "session_id": "<string>",
      "created": 123,
      "status": "<string>",
      "input": [
        {
          "role": "<string>",
          "content": "<string>"
        }
      ],
      "output": [
        {
          "role": "<string>",
          "content": [
            {
              "type": "<string>",
              "text": "<string>"
            }
          ]
        }
      ],
      "citations": [
        {
          "source": "<string>",
          "section_paths": [
            [
              "<string>"
            ]
          ],
          "pages": [
            123
          ],
          "score": 123,
          "grounding": "<string>",
          "kind": "<string>",
          "source_path": "<string>",
          "query_id": "<string>",
          "steps": [
            "<string>"
          ],
          "artifact_name": "<string>",
          "sources": [
            "<string>"
          ]
        }
      ],
      "steps": [
        {
          "step_id": "<string>",
          "status": "<string>",
          "commentary": "<string>",
          "fns": [
            "<string>"
          ],
          "strategy": {
            "kind": "<string>",
            "fns": [
              "<string>"
            ],
            "label": "<string>",
            "scope": [
              "<string>"
            ]
          },
          "tool_calls": [
            {
              "fn": "<string>",
              "category": "<string>",
              "args": {},
              "result": "<unknown>",
              "duration_ms": 123,
              "ok": true,
              "score_space": "<string>",
              "error": "<string>"
            }
          ],
          "code": "<string>",
          "trace_truncated": {
            "truncated": true,
            "dropped_documents": 123,
            "dropped_tool_calls": 123
          },
          "cost": {
            "tokens_in": 123,
            "tokens_out": 123,
            "decide_ms": 123,
            "execute_ms": 123,
            "tokens_in_cached": 123,
            "tokens_in_cache_write": 123,
            "tokens_in_fresh": 123
          },
          "input_tokens": 123,
          "output_tokens": 123,
          "total_tokens": 123,
          "cum_input_tokens": 123,
          "cum_output_tokens": 123
        }
      ],
      "usage": {
        "input_tokens": 123,
        "output_tokens": 123,
        "total_tokens": 123
      },
      "runtime_ms": 123,
      "model": "<string>",
      "error": "<string>",
      "previous_query_id": "<string>",
      "comparison": [
        {
          "workflow": "<string>",
          "query_id": "<string>",
          "model": "<string>"
        }
      ],
      "feedback": {
        "rating": "<string>",
        "comment": "<string>"
      },
      "output_json": {},
      "max_steps": 123,
      "thinking_level": "<string>",
      "rollup": {
        "type": "<string>",
        "query_id": "<string>",
        "n_steps": 123,
        "n_tool_calls": 123,
        "by_category": {},
        "total_hits": 123,
        "duration_ms": 123,
        "cache_read_tokens": 123,
        "cache_write_tokens": 123
      },
      "synthesis": {
        "type": "<string>",
        "query_id": "<string>",
        "status": "<string>",
        "tokens_in": 123,
        "tokens_out": 123,
        "ms": 123,
        "answer_preview": "<string>",
        "tokens_in_cached": 123,
        "tokens_in_cache_write": 123,
        "tokens_in_fresh": 123
      },
      "trace_ref": "<string>"
    }
  ],
  "workspace": "<string>",
  "title": "<string>",
  "system_prompt": "<string>",
  "guardrails": "<string>",
  "workflow": "<string>",
  "last_query_id": "<string>"
}

Authorizations

bearerAuthapiKey

Authorization · string · header · required

Session token from POST /auth/login, sent as Authorization: Bearer <token>.

Headers

X-Pinecone-Api-Version · string · default: 2026-07

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.

Path Parameters

id · string · required

Session id.

Response

200

application/json

The session fields plus a queries array of query turns

The session, with its turns.

id · string · required

Session id, ses_<uuid>.

project_id · string · required

The Pinecone project that owns the session.

created_by · string · required

Principal whose first turn created the session.

scope · string[] · required

Pinned context UUIDs (1–10) every turn searches.

A pinned context UUID.

models · string[] · required

Pinned model fallback list, in preference order.

A catalog model id or tier name.

tools · string[] · required

Tool names the session's turns may call.

A tool name.

created_at · string<date-time> · required

When the session was created.

updated_at · string<date-time> · required

When the session last changed.

queries · Query turn · object[] · required

The session's turns, oldest first.

Show child attributes

workspace · string

Owning workspace. Absent off a workspace-enabled cluster.

title · string | null

Display title derived from the opening ask. Null until one is written.

system_prompt · string | null

Instructions pinned at session creation. Null when none were given.

guardrails · string | null

Guardrails pinned at session creation. Null when none were given.

workflow · string | null

The workflow this session's turns run

last_query_id · string | null

The most recent turn. Null on a session with no turns yet.