get-work-item-by-key-tool

Returns a detailed snapshot of one work item including project, customer, sprint, workflow status, work type, assignee, reporter, deadline, parent, and timestamps. Use this when an AI client receives an issue key in a user message and needs full context to answer or act.

Inputs

Name	Type	Required	Description
`work_item_key`	string	yes	The work item issue key (e.g. `ACM-123`).

Permissions

project_management::view_backlog.

Example

{
  "work_item_key": "ACM-123"
}

Response

{
  "id": 42,
  "issue_key": "ACM-123",
  "title": "Stripe SDK upgrade",
  "description": "Replace the legacy Stripe SDK with…",
  "priority": "high",
  "due_date": "2026-06-01",
  "estimation": 240,
  "remaining_estimate": 180,
  "version": 7,
  "project": { "id": 3, "title": "ACME website", "customer": { "id": 1, "name": "ACME", "code": "ACM" } },
  "workflow_status": { "id": 12, "name": "In progress", "color": "#fbbf24", "is_resolution": false },
  "work_type": { "id": 5, "name": "Task", "icon": "check", "color": "#3b82f6" },
  "sprint": { "id": 7, "name": "Sprint 24", "state": "active" },
  "deadline": { "id": 21, "description": "Launch v2", "due_date": "2026-06-01", "is_finished": false },
  "assignee": { "id": 18, "name": "Pia Nielsen", "email": "pia@example.com" },
  "reporter": { "id": 4, "name": "Tomáš Horák", "email": "tomas@example.com" },
  "parent": null,
  "created_at": "2026-05-10T08:14:02+00:00",
  "updated_at": "2026-05-18T15:22:55+00:00"
}

Errors

An unknown work_item_key returns a validation error.
A caller without project_management::view_backlog receives an authorization error.