Retrieve a work item

Retrieves one source-aware work item with authoritative description and comments when captured, source status and people, hierarchy, children, relationships, and explicit capture states. A Jira issue key such as EA-1650 is accepted directly.

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

Authorization

work-items:readapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Provider work-item UUID or human-facing source key

Example: EA-1650

Query parameters

project_idstringrequired

DigitalStack project whose configured source provider owns the work item

Example: proj_01k2...

Request

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

curl -X GET "https://www.digitalstack360.com/api/v1/work-items/EA-1650?project_id=proj_01k2..." \
  -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": "4ef6f8b4-...",
    "project_id": "proj_01k2...",
    "key": "EA-1650",
    "title": "Celigo F-007: delta catalog sync using modified-since and active filters",
    "description": "Synchronize catalog deltas while excluding inactive products.",
    "kind": "task",
    "status_bucket": "in_progress",
    "parent": {
      "id": "73cc...",
      "project_id": "proj_01k2...",
      "key": "EA-2055",
      "title": "Celigo initiative",
      "kind": "story",
      "status_bucket": "in_progress"
    },
    "children": [
      {
        "id": "9d12...",
        "key": "EA-1651",
        "title": "Verify delta filter",
        "status_bucket": "todo"
      }
    ],
    "acceptance_criteria": [],
    "comments": {
      "items": [
        {
          "author_name": "Alex Morgan",
          "created_at": "2026-07-20T10:00:00Z",
          "updated_at": "2026-07-20T10:00:00Z",
          "body": "The modified-since filter is ready for validation."
        }
      ],
      "total": 1,
      "truncated": false
    },
    "relationships": [
      {
        "type": "blocks",
        "direction": "outbound",
        "work_item": {
          "id": "8b91...",
          "key": "EA-1700",
          "title": "Catalog validation",
          "kind": "task",
          "status_bucket": "todo"
        }
      }
    ],
    "source_detail": {
      "provider": "jira",
      "source_label": "Jira",
      "read_only_mirror": true,
      "status": "In Progress",
      "priority": "High",
      "assignee_name": "Alex Morgan",
      "reporter_name": "Jordan Lee",
      "resolution": null,
      "components": [
        "Catalog"
      ],
      "fix_versions": [
        "Release 7"
      ],
      "story_points": 5,
      "sprint_names": [
        "Sprint 42"
      ]
    },
    "recent_transitions": [],
    "capture": {
      "description": "captured",
      "acceptance_criteria": "not_captured",
      "comments": "captured",
      "relationships": "captured",
      "transition_history": "not_captured",
      "attachments": "not_captured"
    }
  }
}

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

project_id_required

project_id is required to resolve the project source provider

404

not_found

Work item does not exist or is outside the resolved workspace