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

# Get a single task

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

## Request

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

Returns a single task with its children.

## Path parameters

- `canvas_id` string, uuid, required
- `task_id` string, uuid, required

## Response `200`

Task detail.

- GetTaskResponse
  - `success` true, required
  - `data` 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)