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

# Changes to Update an agent

`POST /agents/{agent_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 554 revisions.

- **2026-10-29** `5029b1cd1a90`: 2 info
- **2026-10-28** `584627423036`: 2 info
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 3 info
- **2026-10-16** `909d15009c82`: 1 info
- **2026-10-01** `e3373b531836`: 1 breaking
- **2026-09-29** `1c3e85fd629d`: 1 breaking, 3 info
- **2026-09-25** `d86203de41ae`: 1 info
- **2026-09-25** `82d76d5c86cf`: 1 warning, 1 info
- **2026-09-10** `f2dae1a9aced`: 1 info

## Changes

- **2026-10-29** `5029b1cd1a90`: 2 info
  - added the new optional request property `experimental`
  - added the optional property `experimental` to the response with the `200` status
- **2026-10-28** `584627423036`: 2 info
  - added the new optional request property `compaction`
  - added the optional property `compaction` to the response with the `200` status
- **2026-10-23** `3af3b5fec3f6`: 1 breaking, 3 info
  - added `#/components/schemas/PersistedAgentToolResourceAutomations` to the `tools/items/` response property `oneOf` list for the response status `200`
  - added `automations` discriminator mapping keys to the `tools/items/` request property
  - added `#/components/schemas/PersistedAgentToolConfigParamAutomations` to the `tools/items/` request property `oneOf` list
  - added `automations` discriminator mapping keys to the `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 `service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-10-01** `e3373b531836`: 1 breaking
  - removed the enum value `ultrafast` of the request property `service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-09-29** `1c3e85fd629d`: 1 breaking, 3 info
  - added `#/components/schemas/PersistedAgentToolResourceComputerUse` to the `tools/items/` response property `oneOf` list for the response status `200`
  - added `computer_use` discriminator mapping keys to the `tools/items/` request property
  - added `#/components/schemas/PersistedAgentToolConfigParamComputerUse` to the `tools/items/` request property `oneOf` list
  - added `computer_use` discriminator mapping keys to the `tools/items/` response property for the response status `200`
- **2026-09-25** `d86203de41ae`: 1 info
  - added the non-success response with the status `403`
- **2026-09-25** `82d76d5c86cf`: 1 warning, 1 info
  - added the new `ultrafast` enum value to the `service_tier` response property for the response status `200`
  - added the new `ultrafast` enum value to the request property `service_tier/anyOf[#/components/schemas/ServiceTierParam]/`
- **2026-09-10** `f2dae1a9aced`: 1 info
  - endpoint added

---

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