--- title: "Changes to Create a run" method: POST path: "/agent/runs" --- # Changes to Create a run `POST /agent/runs` > Every recorded change to this operation, newest first. ## Timeline Changed in 15 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`: 10 breaking, 9 info - **2026-10-21** `45589c083133`: 10 breaking, 9 info - **2026-10-09** `b1b94e1eb6f0`: 1 info - **2026-10-08** `9836dac5075a`: 1 info - **2026-09-25** `9006c0dd9616`: 1 breaking, 2 warning, 4 info - **2026-09-23** `6ab7c7b4a7b5`: 1 warning, 1 info - **2026-09-01** `3a085705a03b`: 1 warning, 1 info - **2026-08-27** `67abccbd77b6`: 2 warning - **2026-08-26** `bcc51991b48a`: 1 info - **2026-08-08** `5c7114e0ef43`: 1 warning, 3 info - **2026-08-04** `982a352e3781`: 2 breaking, 5 warning, 14 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`: 10 breaking, 9 info - removed the enum value `affiliate` of the request property `dataSources/items/provider` - removed the enum value `baselayer` of the request property `dataSources/items/provider` - removed the enum value `fiber` of the request property `dataSources/items/provider` - removed the enum value `financial_datasets` of the request property `dataSources/items/provider` - removed the enum value `jinko` of the request property `dataSources/items/provider` - removed the enum value `macrobond` of the request property `dataSources/items/provider` - removed the enum value `particle` of the request property `dataSources/items/provider` - removed the enum value `polymarket` of the request property `dataSources/items/provider` - removed the enum value `similarweb` of the request property `dataSources/items/provider` - the `dataSources/items/provider` request property's minLength was increased from `0` to `1` - 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`: 10 breaking, 9 info - removed the enum value `affiliate` of the request property `dataSources/items/provider` - removed the enum value `baselayer` of the request property `dataSources/items/provider` - removed the enum value `fiber` of the request property `dataSources/items/provider` - removed the enum value `financial_datasets` of the request property `dataSources/items/provider` - removed the enum value `jinko` of the request property `dataSources/items/provider` - removed the enum value `macrobond` of the request property `dataSources/items/provider` - removed the enum value `particle` of the request property `dataSources/items/provider` - removed the enum value `polymarket` of the request property `dataSources/items/provider` - removed the enum value `similarweb` of the request property `dataSources/items/provider` - the `dataSources/items/provider` request property's minLength was increased from `0` to `1` - 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-09** `b1b94e1eb6f0`: 1 info - added the new optional request property `userIdentifier` - **2026-10-08** `9836dac5075a`: 1 info - added the non-success response with the status `403` - **2026-09-25** `9006c0dd9616`: 1 breaking, 2 warning, 4 info - removed the enum value `max` of the request property `effort` - 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 new optional request property `budget/maxDurationSeconds` - added the new `ultra` enum value to the request property `effort` - 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, 1 info - added the new `macrobond` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200` - added the new `macrobond` enum value to the request property `dataSources/items/provider` - **2026-09-01** `3a085705a03b`: 1 warning, 1 info - added the new `polymarket` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/dataSources/items/provider` response property for the response status `200` - added the new `polymarket` enum value to the request property `dataSources/items/provider` - **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, 3 info - added the new `max` enum value to the `request/anyOf[#/components/schemas/AgentRunRequest]/effort` response property for the response status `200` - added the new `max` enum value to the request property `effort` - request property `budget` reactivated - added the optional property `request/anyOf[#/components/schemas/AgentRunRequest]/budget` to the response with the `200` status - **2026-08-04** `982a352e3781`: 2 breaking, 5 warning, 14 info - removed the enum value `agent-2026-05-07` from the `header` request parameter `Exa-Beta` - the `usage/agentComputeUnits` response's property type changed from `integer` to `number` for status `200` - 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 `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 new optional request property `dataSources` - the `header` request parameter `Exa-Beta` became optional - added the new `minimal` enum value to the request property `effort` - 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 `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 `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/post.md) - [API](https://skmtc.dev/exa/apis/exa-public-api.md) - [Page](https://skmtc.dev/exa/apis/exa-public-api/changes/agent/runs/post)