---
title: "Changes to List agent sessions"
method: GET
path: "/agents/sessions"
---

# Changes to List agent sessions

`GET /agents/sessions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 554 revisions.

- **2026-10-30** `f13a1920916a`: 1 info
- **2026-10-29** `5029b1cd1a90`: 1 info
- **2026-10-28** `584627423036`: 1 info
- **2026-10-27** `b7f3ab500153`: 1 info
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 1 info
- **2026-10-16** `bd21bf914a07`: 1 warning
- **2026-10-08** `d747b8568df2`: 1 info
- **2026-10-08** `c0ddcaf59f3d`: 1 breaking, 1 warning
- **2026-09-29** `1c3e85fd629d`: 2 breaking, 3 info
- **2026-09-29** `977c132ac3d0`: 1 info
- **2026-09-25** `82d76d5c86cf`: 1 warning
- **2026-09-10** `f2dae1a9aced`: 1 info

## Changes

- **2026-10-30** `f13a1920916a`: 1 info
  - added the optional property `data/items/review` to the response with the `200` status
- **2026-10-29** `5029b1cd1a90`: 1 info
  - added the optional property `data/items/agent/experimental` to the response with the `200` status
- **2026-10-28** `584627423036`: 1 info
  - added the optional property `data/items/agent/compaction` to the response with the `200` status
- **2026-10-27** `b7f3ab500153`: 1 info
  - added the new optional `query` request parameter `metadata`
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 1 info
  - added `#/components/schemas/AgentToolResourceAutomations` to the `data/items/agent/tools/items/` response property `oneOf` list for the response status `200`
  - added `automations` discriminator mapping keys to the `data/items/agent/tools/items/` response property for the response status `200`
- **2026-10-16** `bd21bf914a07`: 1 warning
  - removed the optional property `data/items/spend_control` from the response with the `200` status
- **2026-10-08** `d747b8568df2`: 1 info
  - added the optional property `data/items/spend_control` to the response with the `200` status
- **2026-10-08** `c0ddcaf59f3d`: 1 breaking, 1 warning
  - for the `query` request parameter `limit`, default value `20` was added
  - for the `query` request parameter `limit`, the max was set to `100.00`
- **2026-09-29** `1c3e85fd629d`: 2 breaking, 3 info
  - added `#/components/schemas/AgentToolResourceComputerUse` to the `data/items/agent/tools/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SessionRequiredActionResourceComputerUseApprovalRequest` to the `data/items/required_actions/items/` response property `oneOf` list for the response status `200`
  - added `computer_use` discriminator mapping keys to the `data/items/agent/tools/items/` response property for the response status `200`
  - added `computer_use_approval_request` discriminator mapping keys to the `data/items/required_actions/items/` response property for the response status `200`
  - added the required property `data/items/environment/oneOf[#/components/schemas/EnvironmentResourceOpenaiHosted]/desktop` to the response with the `200` status
- **2026-09-29** `977c132ac3d0`: 1 info
  - added the optional property `data/items/environment/oneOf[#/components/schemas/EnvironmentResourceOpenaiHosted]/container_size` to the response with the `200` status
- **2026-09-25** `82d76d5c86cf`: 1 warning
  - added the new `ultrafast` enum value to the `data/items/agent/service_tier` response property for the response status `200`
- **2026-09-10** `f2dae1a9aced`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/openai/apis/openai-api-4/docs/agents/sessions/get.md) - [API](https://skmtc.dev/openai/apis/openai-api-4.md) - [Page](https://skmtc.dev/openai/apis/openai-api-4/changes/agents/sessions/get)