---
title: "Changes to Cancel a run"
method: POST
path: "/agent/runs/{id}/cancel"
---

# Changes to Cancel a run

`POST /agent/runs/{id}/cancel`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 43 revisions.

- **2026-10-30** `9fa4de48c6af`: 1 info
- **2026-10-21** `f21ac0e3accc`: 4 breaking, 7 info
- **2026-10-21** `cffbc4a535af`: 4 breaking, 7 info
- **2026-10-21** `7ff6ae62f664`: 9 info
- **2026-10-21** `45589c083133`: 9 info
- **2026-10-08** `9836dac5075a`: 1 info
- **2026-09-25** `9006c0dd9616`: 2 warning, 2 info
- **2026-09-23** `6ab7c7b4a7b5`: 1 warning
- **2026-09-01** `3a085705a03b`: 1 warning
- **2026-08-27** `67abccbd77b6`: 2 warning
- **2026-08-26** `bcc51991b48a`: 1 info
- **2026-08-08** `5c7114e0ef43`: 1 warning, 1 info
- **2026-08-04** `982a352e3781`: 1 breaking, 7 warning, 13 info
- **2026-06-07** `25384fdd189e`: 1 info

## Changes

- **2026-10-30** `9fa4de48c6af`: 1 info
  - added the required property `error` to the response with the `200` status
- **2026-10-21** `f21ac0e3accc`: 4 breaking, 7 info
  - the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response's property type changed from `string` to no type for status `200`
  - the `usage/emails` response's property type changed from `integer` to `number` for status `200`
  - the `usage/phoneNumbers` response's property type changed from `integer` to `number` for status `200`
  - the `usage/searches` response's property type changed from `integer` to `number` for status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9` to the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property `anyOf` list for the response status `200`
  - removed the `budget_reached` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `cancelled` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `error` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `schema_satisfied` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `stopped` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `time_limit_reached` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
- **2026-10-21** `cffbc4a535af`: 4 breaking, 7 info
  - the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response's property type changed from `string` to no type for status `200`
  - the `usage/emails` response's property type changed from `integer` to `number` for status `200`
  - the `usage/phoneNumbers` response's property type changed from `integer` to `number` for status `200`
  - the `usage/searches` response's property type changed from `integer` to `number` for status `200`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9` to the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property `anyOf` list for the response status `200`
  - removed the `budget_reached` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `cancelled` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `error` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `schema_satisfied` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `stopped` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - removed the `time_limit_reached` enum value from the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
- **2026-10-21** `7ff6ae62f664`: 9 info
  - removed the `affiliate` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `baselayer` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `fiber` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `financial_datasets` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `jinko` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `macrobond` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `particle` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `polymarket` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `similarweb` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
- **2026-10-21** `45589c083133`: 9 info
  - removed the `affiliate` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `baselayer` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `fiber` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `financial_datasets` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `jinko` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `macrobond` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `particle` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `polymarket` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
  - removed the `similarweb` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
- **2026-10-08** `9836dac5075a`: 1 info
  - added the non-success response with the status `403`
- **2026-09-25** `9006c0dd9616`: 2 warning, 2 info
  - added the new `time_limit_reached` enum value to the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
  - added the new `ultra` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/effort` response property for the response status `200`
  - added the optional property `request/anyOf[#/components/schemas/AgentRunRequest]/budget/maxDurationSeconds` to the response with the `200` status
  - removed the `max` enum value from the `request/anyOf[#/components/schemas/AgentRunRequest]/effort` response property for the response status `200`
- **2026-09-23** `6ab7c7b4a7b5`: 1 warning
  - added the new `macrobond` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
- **2026-09-01** `3a085705a03b`: 1 warning
  - added the new `polymarket` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200`
- **2026-08-27** `67abccbd77b6`: 2 warning
  - deleted the `header` request parameter `Exa-Version`
  - added the new `stopped` enum value to the `stopReason/anyOf[#/components/schemas/AgentStopReason]/` response property for the response status `200`
- **2026-08-26** `bcc51991b48a`: 1 info
  - added the new optional `header` request parameter `Exa-Version`
- **2026-08-08** `5c7114e0ef43`: 1 warning, 1 info
  - added the new `max` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/effort` response property for the response status `200`
  - added the optional property `request/anyOf[#/components/schemas/AgentRunRequest]/budget` to the response with the `200` status
- **2026-08-04** `982a352e3781`: 1 breaking, 7 warning, 13 info
  - the `usage/agentComputeUnits` response's property type changed from `integer` to `number` for status `200`
  - deleted the `header` request parameter `Exa-Beta`
  - added the new `INVALID_DATA_SOURCE` enum value to the `error/code` response property for the response status `400`
  - added the new `INVALID_DATA_SOURCE` enum value to the `error/code` response property for the response status `401`
  - added the new `INVALID_DATA_SOURCE` enum value to the `error/code` response property for the response status `404`
  - added the new `INVALID_DATA_SOURCE` enum value to the `error/code` response property for the response status `429`
  - added the new `INVALID_DATA_SOURCE` enum value to the `error/code` response property for the response status `500`
  - added the new `minimal` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/effort` response property for the response status `200`
  - added the optional property `costDollars/dataSources` to the response with the `200` status
  - added the optional property `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources` to the response with the `200` status
  - added the optional property `usage/dataSources` to the response with the `200` status
  - removed the `INVALID_BETA_HEADER` enum value from the `error/code` response property for the response status `400`
  - removed the `INVALID_BETA_HEADER` enum value from the `error/code` response property for the response status `401`
  - removed the `INVALID_BETA_HEADER` enum value from the `error/code` response property for the response status `404`
  - removed the `INVALID_BETA_HEADER` enum value from the `error/code` response property for the response status `429`
  - removed the `INVALID_BETA_HEADER` enum value from the `error/code` response property for the response status `500`
  - removed the `MISSING_BETA_HEADER` enum value from the `error/code` response property for the response status `400`
  - removed the `MISSING_BETA_HEADER` enum value from the `error/code` response property for the response status `401`
  - removed the `MISSING_BETA_HEADER` enum value from the `error/code` response property for the response status `404`
  - removed the `MISSING_BETA_HEADER` enum value from the `error/code` response property for the response status `429`
  - removed the `MISSING_BETA_HEADER` enum value from the `error/code` response property for the response status `500`
- **2026-06-07** `25384fdd189e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/exa/apis/exa-public-api/docs/agent/runs/:id/cancel/post.md) - [API](https://skmtc.dev/exa/apis/exa-public-api.md) - [Page](https://skmtc.dev/exa/apis/exa-public-api/changes/agent/runs/:id/cancel/post)
