---
title: "List configured task statuses"
method: GET
path: "/task-statuses"
tags: ["Tasks"]
---

# List configured task statuses

`GET /task-statuses`

## Request

- Base URL: `https://app.pencil.ink/api/v1`
- URL: `https://app.pencil.ink/api/v1/task-statuses`
- Auth: HTTP bearer

Returns the ordered visible workflow, including each status's immutable base status and legacy alias.

## Response `200`

The configured task workflow.

- object
  - `data` TaskStatusDefinition[]
    - `id` string, required
    - `name` string, required
    - `color` string, nullable
    - `baseStatus` 'backlog' | 'todo' | 'in_progress' | 'blocked' | 'verifying' | 'done', required
    - `legacyStatus` 'backlog' | 'inbox' | 'in_progress' | 'blocked' | 'review' | 'done', required
    - `isDefault` boolean, required
    - `order` integer, required

## Other responses

- `401`: Missing or invalid API key (`unauthorized`).
- `429`: Rate limit exceeded (`rate_limited`).

---

[API](https://skmtc.dev/pencil/apis/pencil-public-api.md) · [All operations](https://skmtc.dev/pencil/apis/pencil-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pencil/apis/pencil-public-api/revisions/2b842698b76d?raw)