---
title: "Update issue state"
method: PATCH
path: "/api/v1/issue-states/{stateId}"
tags: ["issues"]
---

# Update issue state

`PATCH /api/v1/issue-states/{stateId}`

## Request

- Base URL: `https://api.capy.ai`
- URL: `https://api.capy.ai/api/v1/issue-states/{stateId}`
- Auth: HTTP bearer

## Path parameters

- `stateId` string, required

## Request body

- UpdateIssueStateRequest
  - `name` string
  - `type` 'open' | 'closed'
  - `icon` 'dashed' | 'empty' | 'half' | 'progress' | 'check' | 'x' | 'clock' | 'hourglass' | 'snooze' | 'calendar' | 'pause' | 'hand' | 'stop' | 'chat' | 'question' | 'external' | 'sleep' | 'eye' | 'testtube' | 'search' | 'shield' | 'approved' | 'pull' | 'clipboard' | 'code' | 'rocket' | 'box' | 'package' | 'flag' | 'upload' | 'shipping' | 'truck' | 'parachute' | 'bug' | 'inbox' | 'fire' | 'warning' | 'alert' | 'siren' | 'unknown' | 'idea' | 'circlecheck' | 'checkmark' | 'inboxdone' | 'trophy' | 'archive' | 'minus' | 'ban' | 'duplicate'
  - `color` 'gray' | 'blue' | 'purple' | 'pink' | 'red' | 'orange' | 'yellow' | 'lime' | 'green'

## Response `200`

IssueStateList

- IssueStateListEncoded
  - `items` IssueStateEncoded[], required
    - `id` string, required
    - `name` string, required
    - `type` union, required
      - 'open' | 'closed'
      - string
    - `icon` union, required
      - 'dashed' | 'empty' | 'half' | 'progress' | 'check' | 'x' | 'clock' | 'hourglass' | 'snooze' | 'calendar' | 'pause' | 'hand' | 'stop' | 'chat' | 'question' | 'external' | 'sleep' | 'eye' | 'testtube' | 'search' | 'shield' | 'approved' | 'pull' | 'clipboard' | 'code' | 'rocket' | 'box' | 'package' | 'flag' | 'upload' | 'shipping' | 'truck' | 'parachute' | 'bug' | 'inbox' | 'fire' | 'warning' | 'alert' | 'siren' | 'unknown' | 'idea' | 'circlecheck' | 'checkmark' | 'inboxdone' | 'trophy' | 'archive' | 'minus' | 'ban' | 'duplicate'
      - string
    - `color` union, required
      - 'gray' | 'blue' | 'purple' | 'pink' | 'red' | 'orange' | 'yellow' | 'lime' | 'green'
      - string
    - `isDefault` boolean, required

## Other responses

- `400`: capy/InvalidRequest
- `401`: capy/Unauthorized
- `403`: capy/Forbidden
- `404`: capy/IssueNotFound
- `429`: capy/RateLimited

## Changes

- **2026-10-31** `e3be47264feb`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/capy/apis/capy-api/changes/api/v1/issue-states/:stateId/patch.md)

---

[API](https://skmtc.dev/capy/apis/capy-api.md) - [All operations](https://skmtc.dev/capy/apis/capy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/capy/apis/capy-api/revisions/4663f7dc4e39?raw)