---
title: "Changes to Create Agent"
method: POST
path: "/v1/task-agents"
---

# Changes to Create Agent

`POST /v1/task-agents`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 56 revisions.

- **2026-08-17** `22c2a2291146`: 1 warning, 1 info
- **2026-07-20** `d4e4f170f4f4`: 3 warning, 5 info
- **2026-07-13** `e8a97dc9fce2`: 2 breaking, 7 warning, 14 info
- **2026-06-18** `2562e655b8f2`: 2 breaking, 8 info
- **2026-06-11** `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 `201`
  - added the new `5x-high` enum value to the request property `effort`
- **2026-07-20** `d4e4f170f4f4`: 3 warning, 5 info
  - removed the request property `workspace_id`
  - removed the optional property `account_id` from the response with the `201` status
  - removed the optional property `workspace_id` from the response with the `201` status
  - api operation id `create_agent_api_v2_public_web_search_agents_post` removed and replaced with `create_agent_public_v1_api_v1_public_web_search_agents_post`
  - endpoint deprecated
  - the `allow` response's property default value `` was removed for the status `201`
  - the `block` response's property default value `` was removed for the status `201`
  - added the required property `sources/block/items/id` to the response with the `201` status
- **2026-07-13** `e8a97dc9fce2`: 2 breaking, 7 warning, 14 info
  - removed `#/components/schemas/AgentUseCase` from the `use_case` request property `anyOf` list
  - request property `effort` was restricted to a list of enum values
  - deleted the `cookie` request parameter `token`
  - removed the optional property `workspace_name` from the response with the `201` status
  - added the new `high` enum value to the `effort` response property for the response status `201`
  - added the new `low` enum value to the `effort` response property for the response status `201`
  - added the new `max` enum value to the `effort` response property for the response status `201`
  - added the new `medium` enum value to the `effort` response property for the response status `201`
  - added the new `x-high` enum value to the `effort` response property for the response status `201`
  - api operation id `create_agent_v2_web_search_agents_post` removed and replaced with `create_agent_api_v2_public_web_search_agents_post`
  - api tag `Web Search Agents (public)` added
  - api tag `Web Search Agents` removed
  - added `#/components/schemas/WebSearchAgentUseCase` to the `use_case` request property `anyOf` list
  - the `effort` request property default value changed from `research` to `high`
  - added the new `high` enum value to the request property `effort`
  - added the new `low` enum value to the request property `effort`
  - added the new `max` enum value to the request property `effort`
  - added the new `medium` enum value to the request property `effort`
  - added the new `x-high` enum value to the request property `effort`
  - the response property `sources/block/items/order` became required for the status `201`
  - the `allow` response's property default value `` was added for the status `201`
  - the `block` response's property default value `` was added for the status `201`
  - the `order` response's property default value `0` was removed for the status `201`
- **2026-06-18** `2562e655b8f2`: 2 breaking, 8 info
  - the `sources` request property type changed from `array` to `object`
  - the `sources` response's property type changed from `array` to `object` for status `201`
  - added the new optional request property `sources/allow`
  - added the new optional request property `sources/avoid`
  - added the new optional request property `sources/block`
  - added the new optional request property `sources/prioritize`
  - added the optional property `sources/allow` to the response with the `201` status
  - added the optional property `sources/avoid` to the response with the `201` status
  - added the optional property `sources/block` to the response with the `201` status
  - added the optional property `sources/prioritize` to the response with the `201` status
- **2026-06-11** `421a9851d61b`: 1 info
  - endpoint added

---

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