Create a task on a board
Creates a new task and places it on the board. If no columnId is specified, the task is placed in the default column. Auto-assigns an incrementing taskNumber. API tokens need the `tasks:write` scope. Reviewers can only create tasks in columns flagged `reviewersCanContribute` (403 `reviewerCannotContributeHere`); an assignee who cannot see the board's visibility is rejected (400 `invalidAssignee`). When `announce` is provided, an assistant reply carrying the new task is posted in `announce.chatId` as a reply to `announce.messageId`; announce failures never fail the request.
Creates a new task and places it on the board. If no columnId is specified, the task
is placed in the default column. Auto-assigns an incrementing taskNumber. API tokens
need the tasks:write scope. Reviewers can only create tasks in columns flagged
reviewersCanContribute (403 reviewerCannotContributeHere); an assignee who cannot
see the board's visibility is rejected (400 invalidAssignee).
When announce is provided, an assistant reply carrying the new task is posted in
announce.chatId as a reply to announce.messageId; announce failures never fail
the request.
Authorization
bearerAuth In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/boards/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks" \ -H "Content-Type: application/json" \ -d '{ "subject": "string" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "creatorId": "688ebf54-d343-4104-8711-82c2feac534a", "creator": "1dccd4a6-75d2-43aa-a088-76d941f1b60a", "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8", "project": "9ec8a81a-31b2-4a83-bcd8-cef9150932d2", "assignedToId": "7a15e53b-1403-4928-9451-d7062c3a8737", "assignedTo": "7869c1a9-a680-4086-b6f5-9e78a651f6f2", "originId": "aae96add-b528-41c7-bc74-5164403b34b2", "origin": "25c01b72-1ac4-4529-8608-f700e1b2b431", "originType": "chatMessage", "relatedToId": "c2b6bd54-2a1c-405f-9ac0-54e3862dbbad", "relatedTo": "378c13a9-e20d-414b-882a-16755f7f0eba", "relatedToType": "project", "status": "pending", "acknowledged": false, "visibility": "creator", "mentions": [ "777c52f7-3433-49cb-b0a3-cd6473c2c951" ], "followers": [ "6021b93c-6a2e-4145-985c-40bb9e171532" ], "subject": "string", "body": "string", "description": "string", "boardId": "a654038e-9287-48a2-acfd-90b8cfa8b1f4", "columnId": "b0676e1a-d8a0-4c5f-99e7-a0ee8909f6dd", "sortOrder": 0, "taskNumber": 0, "tags": [ "a424dc99-d215-4281-ad2d-a3a9bc179925" ], "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46", "inheritance": "6cbbda6a-db01-4bd0-b925-d9ee2f34cc11", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z"}