---
title: "Changes to List Sessions Route"
method: GET
path: "/api/v1/sessions"
---

# Changes to List Sessions Route

`GET /api/v1/sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 20 revisions.

- **2026-10-26** `3e25bef24f8f`: 7 info
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
- **2026-08-27** `9efbf54a37d4`: 16 breaking, 34 warning, 19 info
- **2026-08-25** `e63bfe8e38b4`: 7 breaking, 3 warning, 55 info

## Changes

- **2026-10-26** `3e25bef24f8f`: 7 info
  - added the new optional `query` request parameter `state`
  - added the new optional `query` request parameter `sub_agent`
  - added the optional property `items/items/escalated_calls` to the response with the `200` status
  - added the optional property `items/items/failed_calls` to the response with the `200` status
  - added the optional property `items/items/has_linked_calls` to the response with the `200` status
  - added the optional property `items/items/state` to the response with the `200` status
  - added the optional property `items/items/sub_agents` to the response with the `200` status
- **2026-09-27** `b20a3bdd6219`: 1 breaking, 1 warning, 2 info
  - removed the required property `items/items/proxy` from the response with the `200` status
  - deleted the `query` request parameter `proxy_id`
  - added the new optional `query` request parameter `agent_id`
  - added the required property `items/items/agent` to the response with the `200` status
- **2026-08-27** `9efbf54a37d4`: 16 breaking, 34 warning, 19 info
  - removed the required property `items/items/integration_names` from the response with the `200` status
  - removed the required property `items/items/intent_action` from the response with the `200` status
  - removed the required property `items/items/intent_score` from the response with the `200` status
  - removed the required property `items/items/latency_ms` from the response with the `200` status
  - removed the required property `items/items/model` from the response with the `200` status
  - removed the required property `items/items/org_id` from the response with the `200` status
  - removed the required property `items/items/policy_decision` from the response with the `200` status
  - removed the required property `items/items/provider` from the response with the `200` status
  - removed the required property `items/items/proxy_id` from the response with the `200` status
  - removed the required property `items/items/request_tokens` from the response with the `200` status
  - removed the required property `items/items/response_tokens` from the response with the `200` status
  - removed the required property `items/items/status_code` from the response with the `200` status
  - removed the required property `items/items/stream` from the response with the `200` status
  - removed the required property `items/items/timestamp` from the response with the `200` status
  - removed the required property `items/items/tool_names` from the response with the `200` status
  - removed the required property `items/items/trace_id` from the response with the `200` status
  - deleted the `query` request parameter `decision`
  - deleted the `query` request parameter `provider`
  - deleted the `query` request parameter `session_id`
  - deleted the `query` request parameter `step_type`
  - deleted the `query` request parameter `trace_flow_id`
  - removed the optional property `items/items/custom_properties` from the response with the `200` status
  - removed the optional property `items/items/guardrail_decision` from the response with the `200` status
  - removed the optional property `items/items/guardrail_duration_ms` from the response with the `200` status
  - removed the optional property `items/items/guardrail_name` from the response with the `200` status
  - removed the optional property `items/items/guardrail_reason` from the response with the `200` status
  - removed the optional property `items/items/guardrail_rule` from the response with the `200` status
  - removed the optional property `items/items/guardrail_stage` from the response with the `200` status
  - removed the optional property `items/items/intent_latency_ms` from the response with the `200` status
  - removed the optional property `items/items/intent_reason` from the response with the `200` status
  - removed the optional property `items/items/matched_capability` from the response with the `200` status
  - removed the optional property `items/items/parent_trace_id` from the response with the `200` status
  - removed the optional property `items/items/policy_rule` from the response with the `200` status
  - removed the optional property `items/items/request_messages` from the response with the `200` status
  - removed the optional property `items/items/request_system_prompt` from the response with the `200` status
  - removed the optional property `items/items/request_tools` from the response with the `200` status
  - removed the optional property `items/items/response_body` from the response with the `200` status
  - removed the optional property `items/items/session_turn` from the response with the `200` status
  - removed the optional property `items/items/step_index` from the response with the `200` status
  - removed the optional property `items/items/step_stage` from the response with the `200` status
  - …29 more
- **2026-08-25** `e63bfe8e38b4`: 7 breaking, 3 warning, 55 info
  - the response property `items/items/session_id` became optional for the status `200`
  - response property `items/items/session_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the required property `items/items/call_count` from the response with the `200` status
  - removed the required property `items/items/first_call_at` from the response with the `200` status
  - removed the required property `items/items/last_call_at` from the response with the `200` status
  - removed the required property `items/items/total_request_tokens` from the response with the `200` status
  - removed the required property `items/items/total_response_tokens` from the response with the `200` status
  - deleted the `query` request parameter `session_name`
  - removed the optional property `items/items/avg_latency_ms` from the response with the `200` status
  - removed the optional property `items/items/session_name` from the response with the `200` status
  - api operation id `list_sessions_route_api_v1_sessions_get` removed and replaced with `list_traces_route_api_v1_sessions_get`
  - api tag `sessions` added
  - api tag `traces` removed
  - added the new optional `query` request parameter `decision`
  - added the new optional `query` request parameter `from`
  - added the new optional `query` request parameter `provider`
  - added the new optional `query` request parameter `session_id`
  - added the new optional `query` request parameter `step_type`
  - added the new optional `query` request parameter `to`
  - added the new optional `query` request parameter `trace_flow_id`
  - added the optional property `items/items/custom_properties` to the response with the `200` status
  - added the optional property `items/items/ended_at` to the response with the `200` status
  - added the optional property `items/items/guardrail_decision` to the response with the `200` status
  - added the optional property `items/items/guardrail_duration_ms` to the response with the `200` status
  - added the optional property `items/items/guardrail_name` to the response with the `200` status
  - added the optional property `items/items/guardrail_reason` to the response with the `200` status
  - added the optional property `items/items/guardrail_rule` to the response with the `200` status
  - added the optional property `items/items/guardrail_stage` to the response with the `200` status
  - added the optional property `items/items/intent_latency_ms` to the response with the `200` status
  - added the optional property `items/items/intent_reason` to the response with the `200` status
  - added the optional property `items/items/matched_capability` to the response with the `200` status
  - added the optional property `items/items/parent_trace_id` to the response with the `200` status
  - added the optional property `items/items/policy_rule` to the response with the `200` status
  - added the optional property `items/items/request_messages` to the response with the `200` status
  - added the optional property `items/items/request_system_prompt` to the response with the `200` status
  - added the optional property `items/items/request_tools` to the response with the `200` status
  - added the optional property `items/items/response_body` to the response with the `200` status
  - added the optional property `items/items/session_turn` to the response with the `200` status
  - added the optional property `items/items/started_at` to the response with the `200` status
  - added the optional property `items/items/step_index` to the response with the `200` status
  - …25 more

---

[Operation](https://skmtc.dev/xenovia/apis/controlplane/docs/api/v1/sessions/get.md) - [API](https://skmtc.dev/xenovia/apis/controlplane.md) - [Page](https://skmtc.dev/xenovia/apis/controlplane/changes/api/v1/sessions/get)