> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Raycast task statuses

> Discover status slugs and completion flags for the authorized workspace.

Discover status slugs and completion flags for the authorized workspace.

Use an OAuth access token issued to `kato-raycast`. Developer keys cannot call this endpoint. See [Raycast authentication](/api-reference/raycast/overview).

Required scopes: `tasks:read`.

Use returned slugs in task writes and `isComplete` to interpret completion. Status names and slugs are workspace-specific.

## Response

**200** — Returns the resource under `data`. Example IDs and values are illustrative.

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "status_example",
        "name": "Todo",
        "slug": "todo",
        "color": "#808080",
        "icon": null,
        "position": 0,
        "isComplete": false,
        "isDefault": true
      }
    ]
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    "https://api.getkato.io/v1/raycast/task-statuses" \
    -H "Authorization: Bearer $KATO_RAYCAST_ACCESS_TOKEN"
  ```
</RequestExample>


## Related topics

- [All endpoints](/api-reference/endpoints.md)
- [List my Raycast tasks](/api-reference/raycast/tasks-list.md)
- [Raycast API](/api-reference/raycast/overview.md)
- [Raycast response models](/api-reference/raycast/models.md)
- [Raycast](/integrations/raycast.md)