---
title: "Get task tree"
method: GET
path: "/v1/canvas/{canvas_id}/tasks"
tags: ["Canvas"]
---

# Get task tree

`GET /v1/canvas/{canvas_id}/tasks`

## Request

- Base URL: `https://api.getspine.ai`
- URL: `https://api.getspine.ai/v1/canvas/{canvas_id}/tasks`
- Auth: API key in header `X-API-KEY`

Returns the full task hierarchy for a canvas:
parent-task → persona-task → tool-call-task.

## Path parameters

- `canvas_id` string, uuid, required

## Response `200`

Task tree grouped by completion state.

- GetTasksResponse
  - `success` true, required
  - `data` object, required
    - `canvas_id` string, uuid, required
    - `completed` Task[], required
      - `task_id` string, uuid, required
      - `name` string, required
      - `task_type` 'parent-task' | 'persona-task' | 'tool-call-task', required
      - `status` string, required
      - `children` Task[]
    - `not_completed` Task[], required
      - `task_id` string, uuid, required
      - `name` string, required
      - `task_type` 'parent-task' | 'persona-task' | 'tool-call-task', required
      - `status` string, required
      - `children` Task[]

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `404`: Resource does not exist or belongs to another account.

---

[API](https://skmtc.dev/getspine/apis/spine-api.md) - [All operations](https://skmtc.dev/getspine/apis/spine-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getspine/apis/spine-api/revisions/5fc71da27327?raw)