---
title: "Changes to Create Run"
method: POST
path: "/v1/task-agents/{agent_id}/runs"
---

# Changes to Create Run

`POST /v1/task-agents/{agent_id}/runs`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 55 revisions.

- **2026-08-17** `22c2a2291146` — 1 warning, 1 info
- **2026-07-20** `d4e4f170f4f4` — 1 breaking, 1 warning, 6 info
- **2026-07-12** `e8a97dc9fce2` — 1 breaking, 5 warning, 15 info
- **2026-07-07** `ebe52c375b71` — 1 breaking
- **2026-06-18** `2562e655b8f2` — 1 info
- **2026-06-10** `421a9851d61b` — 1 info

## Changes

- **2026-08-17** `22c2a2291146` — 1 warning, 1 info
  - added the new `5x-high` enum value to the `effort` response property for the response status `202`
  - added the new `5x-high` enum value to the request property `effort/anyOf[subschema #1: Effort]/`
- **2026-07-20** `d4e4f170f4f4` — 1 breaking, 1 warning, 6 info
  - removed `#/components/schemas/AgentSources` from the `sources` request property `anyOf` list
  - removed the optional property `workspace_id` from the response with the `202` status
  - api operation id `create_run_api_v2_public_web_search_agents__agent_id__runs_post` removed and replaced with `create_run_public_v1_api_v1_public_web_search_agents__agent_id__runs_post`
  - endpoint deprecated
  - added the new optional request property `input_data`
  - added `#/components/schemas/AgentSourcesPublicV1` to the `sources` request property `anyOf` list
  - added `#/components/schemas/TaskRunErrorPublicV1` to the `error` response property `anyOf` list for the response status `202`
  - removed `#/components/schemas/TaskRunError` from the `error` response property `anyOf` list for the response status `202`
- **2026-07-12** `e8a97dc9fce2` — 1 breaking, 5 warning, 15 info
  - for the `path` request parameter `agent_id`, the type/format was changed from `string`/`` to `string`/`uuid`
  - deleted the `cookie` request parameter `token`
  - added the new `high` enum value to the `effort` response property for the response status `202`
  - added the new `low` enum value to the `effort` response property for the response status `202`
  - added the new `medium` enum value to the `effort` response property for the response status `202`
  - added the new `x-high` enum value to the `effort` response property for the response status `202`
  - api operation id `create_run_v2_web_search_agents__agent_id__runs_post` removed and replaced with `create_run_api_v2_public_web_search_agents__agent_id__runs_post`
  - the endpoint scheme security `APIKeyCookie` was added to the API
  - the endpoint scheme security `HTTPBearer` was added to the API
  - api tag `Web Search Agents (public)` added
  - api tag `Web Search Agents` removed
  - added the new optional request property `effort`
  - added the new optional request property `previous_interaction_id`
  - added `#/components/schemas/TaskRunError` to the `error` response property `anyOf` list for the response status `202`
  - removed `#/components/schemas/AgentRunError` from the `error` response property `anyOf` list for the response status `202`
  - the response property `web_search_agent_id` became required for the status `202`
  - removed the `pro` enum value from the `effort` response property for the response status `202`
  - removed the `quick` enum value from the `effort` response property for the response status `202`
  - removed the `quickest` enum value from the `effort` response property for the response status `202`
  - removed the `research` enum value from the `effort` response property for the response status `202`
  - response property `web_search_agent_id` list-of-types was narrowed by removing types `null` from media type `application/json` of response `202`
- **2026-07-07** `ebe52c375b71` — 1 breaking
  - the `web_search_agent_id/anyOf[subschema #1]/` response's property type/format changed from `string`/`uuid` to `string`/`` for status `202`
- **2026-06-18** `2562e655b8f2` — 1 info
  - added the new optional request property `sources`
- **2026-06-10** `421a9851d61b` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/nimbleway/apis/api-gateway/docs/v1/task-agents/:agent_id/runs/post.md) · [API](https://skmtc.dev/nimbleway/apis/api-gateway.md) · [Page](https://skmtc.dev/nimbleway/apis/api-gateway/changes/v1/task-agents/:agent_id/runs/post)