Update Statuses

PUT 
/projects/spaces/:spaceId/statuses

Replaces the whole space status set. Send every group you want to keep — omitted groups and statuses are removed. There is no If-Match and no per-status route. A task that still uses a removed status key keeps that key until you update the task. key is the stable id; label is display text. Status color is any hex. Space, folder, and list color must be one of the 16 palette swatches. A task is complete when properties.statusGroup is done.

Request

Version stringrequired

API Version

Available optionsv3

spaceId stringrequired

Space id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

application/json

Body

Bodyrequired

groupsobject[]required

Complete status groups for the space (full replace — not a partial merge). Tasks that still reference a removed status key keep that key until updated; clients should migrate those tasks before removing keys.

Example (auto)

{
  "groups": [
    {
      "key": "todo",
      "label": "To Do",
      "color": "#E2E8F0",
      "position": 0,
      "statuses": [
        {
          "key": "to_do",
          "label": "To Do",
          "color": "#94A3B8",
          "position": 0
        }
      ]
    },
    {
      "key": "done",
      "label": "Done",
      "color": "#DCFCE7",
      "position": 1,
      "statuses": [
        {
          "key": "complete",
          "label": "Complete",
          "color": "#22C55E",
          "position": 0
        }
      ]
    }
  ]
}

application/json

Successful response

application/json

Schema

Schema

groupsobject[]required

Status groups with nested statuses (key, label, color, position)

Example (auto)

{
  "groups": [
    {
      "key": "todo",
      "label": "To Do",
      "color": "#E2E8F0",
      "position": 0,
      "statuses": [
        {
          "key": "to_do",
          "label": "To Do",
          "color": "#94A3B8",
          "position": 0
        }
      ]
    },
    {
      "key": "done",
      "label": "Done",
      "color": "#BBF7D0",
      "position": 2,
      "statuses": [
        {
          "key": "completed",
          "label": "Completed",
          "color": "#22C55E",
          "position": 0
        }
      ]
    }
  ]
}