Subtasks and checklists

Break a task into subtasks, and read the checklist items on tasks and subtasks.

Subtasks

A subtask belongs to one parent task. It takes the same fields as a task: taskTitle, status, priority, owners, tags, dates and completion. See Create a task for what each field accepts.

Parent task	Subtask path
Project task	`/v1/spaces/{spaceId}/projects/{projectId}/tasks/{taskId}/subtasks`
Personal task	`/v1/tasks/{parentTaskId}/subtasks`

Subtask lists are paginated like task lists and accept the same filters. Updates change only the fields you send.

Checklists

A checklist is a list of items on a task or subtask. Each item has a name, a completed flag, an optional assignee and an orderIndex that sets its position.

A task in Astravue with its Checklist tab open: four items, two of them done

To read	Use
Items on a task	Get all checklists for a parent task
Items on a subtask	Get all checklists for a subtask

Both work for project tasks and personal tasks, and return items in checklist order.

TIP

To add, tick off or remove checklist items, use the Astravue MCP server.

API reference

Action	Project task	Personal task
List subtasks	Get all subtasks	Get all subtasks for a personal task
Create a subtask	Create a subtask	Create a subtask for a personal task
Update a subtask	Update a subtask	Update a subtask for a personal task
Delete a subtask	Delete a subtask	Delete a subtask for a personal task
Read checklists	Parent task, Subtask	Same endpoints

Subtasks#

Checklists#

API reference#

Subtasks

Checklists

API reference