List work-item transitions

Lists recent canonical transition history for one work item. This endpoint is read-only; state-changing transitions are not yet public.

GET/api/v1/work-items/:id/transitions

Authorization

work-items:readapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Canonical work-item ID

Example: work_01k2...

Query parameters

limitnumberoptional

Maximum transitions, 1–100

Example: 50

Request

GET /api/v1/work-items/:id/transitions

curl -X GET "https://www.digitalstack360.com/api/v1/work-items/work_01k2.../transitions" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": [
    {
      "id": "wtr_01k2...",
      "work_item_id": "work_01k2...",
      "from_state_id": "state_todo",
      "to_state_id": "state_doing",
      "from_bucket": "todo",
      "to_bucket": "in_progress",
      "actor_user_id": "user_abc123",
      "source": "user",
      "note": "Started implementation",
      "at": "2026-07-15T15:00:00Z",
      "created_at": "2026-07-15T15:00:00Z"
    }
  ],
  "meta": {
    "limit": 50,
    "count": 1
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks work-items:read scope

400

invalid_limit

limit is outside the 1–100 range

404

not_found

Work item does not exist or is outside the resolved workspace