---
title: "Changes to Create a task"
method: POST
path: "/api/v1/agent/{agentId}/task"
---

# Changes to Create a task

`POST /api/v1/agent/{agentId}/task`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 10 revisions.

- **2024-08-20** `74bdfb8101cc` — 8 breaking, 1 warning, 14 info
- **2024-08-03** `3b82b46ab1d2` — 1 info

## Changes

- **2024-08-20** `74bdfb8101cc` — 8 breaking, 1 warning, 14 info
  - added the new required request property `data`
  - the `task/id` response's property type/format changed from `string`/`uuid` to `string`/`` for status `200`
  - removed the required property `proposal` from the response with the `200` status
  - removed the required property `task/mode` from the response with the `200` status
  - removed the required property `task/paymentState` from the response with the `200` status
  - removed the required property `task/type` from the response with the `200` status
  - removed the required property `task/workspaceId` from the response with the `200` status
  - removed the required property `workspace` from the response with the `200` status
  - removed the request property `task`
  - api operation id `agent.createDefaultTaskForAgent` removed and replaced with `agent.createTask`
  - added the new optional request property `cancelUrl`
  - added the new optional request property `email`
  - added the new optional request property `successUrl`
  - added the new optional request property `test`
  - added the optional property `redirectTo` to the response with the `200` status
  - added the required property `paymentRequired` to the response with the `200` status
  - added the required property `task/agentId` to the response with the `200` status
  - added the required property `task/cost` to the response with the `200` status
  - added the required property `task/paymentComplete` to the response with the `200` status
  - added the required property `task/paymentDetails` to the response with the `200` status
  - added the required property `task/test` to the response with the `200` status
  - added the required property `task/title` to the response with the `200` status
  - added the required property `task/userId` to the response with the `200` status
- **2024-08-03** `3b82b46ab1d2` — 1 info
  - added the required property `task/paymentState` to the response with the `200` status

---

[Operation](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation/docs/api/v1/agent/:agentId/task/post.md) · [API](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation.md) · [Page](https://skmtc.dev/artilla-ai/apis/artilla-api-documentation/changes/api/v1/agent/:agentId/task/post)