Docs
Add Task
POST /tasks
POST
/tasksRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
| Event token | x-Event-Token | Optional | Run **Get Tokens** in the Authorization folder, or call `GET /Events/{eventId}/authorize` manually. |
Creates a new task in the event. The task is automatically placed at the end of its sibling list (based on parentId). All required custom task attributes must be provided. Dependency cycles are rejected.
Returns 201 Created on success.
Requires EventProjectManagementAdmin permission on the event.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Task name. |
| statusId | Guid | Required | ID of the task status to assign. Must exist. |
| startDateTime | DateTime? | Optional | Scheduled start date. |
| endDateTime | DateTime? | Optional | Scheduled end date. |
| description | string | Optional | Task description. |
| priority | string | Optional | Priority level. |
| parentId | Guid? | Optional | Parent task ID to nest under, or `null` for top-level. |
| phaseId | Guid? | Optional | Phase to assign the task to. |
| assignees | AssigneeList | Optional | Users and collaborators to assign. |
| reviewerIds | Guid[] | Optional | User IDs to assign as reviewers. |
| attributes | Attribute[] | Optional | Custom attribute values. All required attributes must be supplied. |
| dependsOn | Guid[] | Optional | IDs of tasks this task depends on. Must not create a cycle. |
AssigneeList
| Field | Type | Description |
|---|---|---|
| userIds | Guid[] | User IDs to assign. |
| collaboratorIds | Guid[] | Collaborator IDs to assign. |
Attribute
| Field | Type | Required | Description |
|---|---|---|---|
| attributeId | Guid | Required | The attribute definition ID. |
| value | string | Required | The value to set. |