---
title: "List the tracker states a mapping row may take"
method: GET
path: "/task-status-mapping/options"
tags: ["Task status mapping"]
---

# List the tracker states a mapping row may take

`GET /task-status-mapping/options`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/task-status-mapping/options`
- Auth: none declared

The connection's default team (Linear), project (Jira) or repository (GitHub), its workflow states, and the tracker's resolutions where it has them, read live from the tracker.

## Query parameters

- `organizationId` string: Organization whose tracker connection holds the mapping. Auto-filled from CLI and SDK context when omitted.
- `provider` 'linear' | 'jira' | 'github', required: Task tracker whose connection holds the mapping.
- `connectionId` string: The tracker connection holding the mapping. Defaults to the organization's live connection for the provider. GitHub may have one per installation.

## Response `200`

OK

- object
  - `provider` 'linear' | 'jira' | 'github', required: Task tracker whose connection holds the mapping.
  - `teamId` string, nullable, required
  - `teamName` string, nullable, required
  - `states` object[], required: The team's workflow states, the choices each row may take. Empty until a default team is set.
    - `ref` string, required: The tracker's id for the state.
    - `name` string, required: The state's name in the tracker.
    - `category` 'open' | 'in_progress' | 'done' | 'canceled', required: The tracker state's neutral category.
  - `resolutions` object[], required: The tracker's resolutions, the choices the Resolved and Ignored rows' resolutions may take. Empty for a tracker without resolutions.
    - `ref` string, required: The tracker's id for the resolution.
    - `name` string, required: The resolution's name in the tracker.
  - `automaticResolutions` object, required: What a row left on Automatic closes with: Resolved takes the tracker's done resolution ("Done", else "Fixed", else "Resolved", else the first that does not cancel), Ignored its first canceling one ("Won't Do", "Duplicate", ...). Null where the tracker offers nothing fitting, and both null for a tracker without resolutions.
    - `resolved` object, nullable, required
      - `ref` string, required: The tracker's id for the resolution.
      - `name` string, required: The resolution's name in the tracker.
    - `ignored` object, nullable, required
      - `ref` string, required: The tracker's id for the resolution.
      - `name` string, required: The resolution's name in the tracker.

## Changes

- **2026-10-21** `7603203773d8`: 1 info
  - added the required property `automaticResolutions` to the response with the `200` status
- **2026-10-21** `3ae568619997`: 1 warning, 2 info
  - added the new `github` enum value to the `provider` response property for the response status `200`
  - added the new optional `query` request parameter `connectionId`
  - added the new enum value `github` to the `query` request parameter `provider`
- **2026-10-20** `b32270ee84f4`: 1 warning, 2 info
  - added the new `jira` enum value to the `provider` response property for the response status `200`
  - added the new enum value `jira` to the `query` request parameter `provider`
  - added the required property `resolutions` to the response with the `200` status
- **2026-10-19** `8961f4901b21`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/task-status-mapping/options/get.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/965b6230cf45?raw)