---
title: "Changes to Create a new task"
method: POST
path: "/api/tasks"
---

# Changes to Create a new task

`POST /api/tasks`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 105 revisions.

- **2026-09-03** `0f5503f5cd28` — 2 warning
- **2026-09-02** `09d5eb030093` — 2 info
- **2026-08-31** `6f2d2fbe2599` — 1 warning, 1 info
- **2026-08-19** `5657aaae1bab` — 2 warning
- **2026-08-07** `06cac6a7c5bc` — 2 info
- **2026-07-11** `f1022d5edb0d` — 1 info
- **2026-07-10** `5b7df66bb887` — 1 info
- **2026-07-02** `0c910612f9ac` — 1 breaking, 1 warning

## Changes

- **2026-09-03** `0f5503f5cd28` — 2 warning
  - added the new `acp` enum value to the `provider` response property for the response status `201`
  - added the new `acp` enum value to the `routingAffinity/harnessProvider` response property for the response status `201`
- **2026-09-02** `09d5eb030093` — 2 info
  - added the optional property `routingAffinity/leadOnly` to the response with the `201` status
  - added the optional property `routingAffinityInvalid` to the response with the `201` status
- **2026-08-31** `6f2d2fbe2599` — 1 warning, 1 info
  - added the new `draft` enum value to the `status` response property for the response status `201`
  - added the new optional request property `draft`
- **2026-08-19** `5657aaae1bab` — 2 warning
  - the `priority` request property's max was set to `100.00`
  - the `priority` request property's min was set to `0.00`
- **2026-08-07** `06cac6a7c5bc` — 2 info
  - added the media type `application/json` for the response with the status `201`
  - added the media type `application/json` for the response with the status `400`
- **2026-07-11** `f1022d5edb0d` — 1 info
  - added the new optional request property `key`
- **2026-07-10** `5b7df66bb887` — 1 info
  - added the new `max` enum value to the request property `effort`
- **2026-07-02** `0c910612f9ac` — 1 breaking, 1 warning
  - removed the enum value `max` of the request property `effort`
  - removed the request property `key`

---

[Operation](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/docs/api/tasks/post.md) · [API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) · [Page](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/tasks/post)