---
title: "Changes to Update an agent session"
method: POST
path: "/agents/sessions/{session_id}"
---

# Changes to Update an agent session

`POST /agents/sessions/{session_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 554 revisions.

- **2026-10-30** `282d01890e28`: 1 info
- **2026-10-30** `f13a1920916a`: 2 info
- **2026-10-29** `5029b1cd1a90`: 1 info
- **2026-10-28** `584627423036`: 1 info
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 1 info
- **2026-10-16** `909d15009c82`: 1 info
- **2026-10-16** `bd21bf914a07`: 2 warning
- **2026-10-08** `d747b8568df2`: 2 info
- **2026-10-01** `e3373b531836`: 1 breaking
- **2026-09-29** `1c3e85fd629d`: 2 breaking, 3 info
- **2026-09-29** `977c132ac3d0`: 1 info
- **2026-09-25** `82d76d5c86cf`: 1 warning, 1 info
- **2026-09-16** `454462775dc0`: 1 info
- **2026-09-10** `f2dae1a9aced`: 1 info

## Changes

- **2026-10-30** `282d01890e28`: 1 info
  - added the new optional request property `agent/tools`
- **2026-10-30** `f13a1920916a`: 2 info
  - added the new optional request property `review`
  - added the optional property `review` to the response with the `200` status
- **2026-10-29** `5029b1cd1a90`: 1 info
  - added the optional property `agent/experimental` to the response with the `200` status
- **2026-10-28** `584627423036`: 1 info
  - added the optional property `agent/compaction` to the response with the `200` status
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 1 info
  - added `#/components/schemas/AgentToolResourceAutomations` to the `agent/tools/items/` response property `oneOf` list for the response status `200`
  - added `automations` discriminator mapping keys to the `agent/tools/items/` response property for the response status `200`
- **2026-10-16** `909d15009c82`: 1 info
  - added the new `ultrafast` enum value to the request property `agent/service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-10-16** `bd21bf914a07`: 2 warning
  - removed the request property `spend_control`
  - removed the optional property `spend_control` from the response with the `200` status
- **2026-10-08** `d747b8568df2`: 2 info
  - added the new optional request property `spend_control`
  - added the optional property `spend_control` to the response with the `200` status
- **2026-10-01** `e3373b531836`: 1 breaking
  - removed the enum value `ultrafast` of the request property `agent/service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-09-29** `1c3e85fd629d`: 2 breaking, 3 info
  - added `#/components/schemas/AgentToolResourceComputerUse` to the `agent/tools/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/SessionRequiredActionResourceComputerUseApprovalRequest` to the `required_actions/items/` response property `oneOf` list for the response status `200`
  - added `computer_use` discriminator mapping keys to the `agent/tools/items/` response property for the response status `200`
  - added `computer_use_approval_request` discriminator mapping keys to the `required_actions/items/` response property for the response status `200`
  - added the required property `environment/oneOf[#/components/schemas/EnvironmentResourceOpenaiHosted]/desktop` to the response with the `200` status
- **2026-09-29** `977c132ac3d0`: 1 info
  - added the optional property `environment/oneOf[#/components/schemas/EnvironmentResourceOpenaiHosted]/container_size` to the response with the `200` status
- **2026-09-25** `82d76d5c86cf`: 1 warning, 1 info
  - added the new `ultrafast` enum value to the `agent/service_tier` response property for the response status `200`
  - added the new `ultrafast` enum value to the request property `agent/service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-09-16** `454462775dc0`: 1 info
  - added the new optional request property `agent`
- **2026-09-10** `f2dae1a9aced`: 1 info
  - endpoint added

---

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