Tasks are the work items in Astravue. Create, update and filter them through the API, in a project or as personal tasks.
Project tasks and personal tasks#
| Project tasks | Personal tasks |
|---|
| Where they live | In a project, inside a space | Outside any project |
| Path | /v1/spaces/{spaceId}/projects/{projectId}/tasks | /v1/tasks |
| A list returns | Tasks in that project you can see | Tasks you created, own, follow or are tagged in |
Create a task#
| Field | What to send | If you leave it out |
|---|
status | A status name. Project tasks use the project's statuses. Upper or lower case both work. | The default status |
priority | A priority label from your workspace | The default priority |
owners | User IDs. For project tasks, they must be members of the project. | You become the owner |
tags | Names of tags that already exist | No tags |
startDate, dueDate | Date-time in ISO 8601 | Not set |
noOfDays | Length in working days. Sent with one date, Astravue works out the other from your workspace's working hours. | Not set |
completion | A number from 0 to 100 | 0 |
To see which status names and priority labels exist, read a task and check status.statusName and priority.priorityLabel. To find user IDs for a project, see Find people to assign. Update a task#
List and filter tasks#
What a task contains#
| Field | Meaning |
|---|
taskId, taskTitle, description | The task itself |
status.statusName, priority.priorityLabel | Current status and priority |
owners, followers | People on the task |
startDate, dueDate, completion, overdueStatus | Schedule and progress |
subTaskCount, parentCommentCount | How many subtasks and top-level comments it has |
blockedByTasks, blockingTasks | Dependencies on other tasks |
customFields | Custom field values. See Custom fields |
API reference#
Modified at 2026-11-10 15:10:12
