---
title: "Changes to Create an externally controlled task"
method: POST
path: "/v1/tasks/external"
---

# Changes to Create an externally controlled task

`POST /v1/tasks/external`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 8 revisions.

- **2026-10-30** `11052d3a9e59`: 2 info
- **2026-10-29** `4baea94e5dbc`: 2 breaking, 5 info
- **2026-10-13** `9d7a35f993ac`: 1 info
- **2026-10-09** `135cef4f7586`: 1 info

## Changes

- **2026-10-30** `11052d3a9e59`: 2 info
  - added the new optional request property `attachments`
  - added the optional property `messages/items/parts/items/anyOf[subschema #3]/versionId` to the response with the `201` status
- **2026-10-29** `4baea94e5dbc`: 2 breaking, 5 info
  - the response property `task/pendingInteraction/anyOf[subschema #1]/prompt` became nullable for the status `201`
  - the response property `task/projectId` became nullable for the status `201`
  - added `subschema #3, subschema #4, subschema #5, subschema #7` to the `messages/items/parts/items/` response property `anyOf` list for the response status `201`
  - removed `subschema #3, subschema #4, subschema #5, subschema #7` from the `messages/items/parts/items/` response property `anyOf` list for the response status `201`
  - response property `task/pendingInteraction/anyOf[subschema #1]/prompt` list-of-types was narrowed by removing types `null` from media type `application/json` of response `201`
  - response property `task/projectId` list-of-types was narrowed by removing types `null` from media type `application/json` of response `201`
  - the `messages/items/createdAt` response's property pattern was changed from `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$` to `^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$` for the status `201`
- **2026-10-13** `9d7a35f993ac`: 1 info
  - added the new optional request property `prompt`
- **2026-10-09** `135cef4f7586`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/adam/apis/adam-api/docs/v1/tasks/external/post.md) - [API](https://skmtc.dev/adam/apis/adam-api.md) - [Page](https://skmtc.dev/adam/apis/adam-api/changes/v1/tasks/external/post)