Get an issue with its current version — call this before update_issue
get_issueGet an issue with its current version — call this before update_issue.
Returns the full issue and its current version. Call this before update_issue, transition_issue, assign_issue, move_to_sprint, rank_issue, link_issues, unlink_issues or delete_issue, and pass the version it returns. People in it (reporter, assignee, created_by, updated_by) are user ids — list_people gives their names. Custom fields (D129): frontmatter.fields holds the values keyed by field id (definitions in get_project fields); flags are the template flags computed now (overdue, bill_due, sla_over …, never stored); computed has the formula fields' values; children summarises its subtasks — for a Sales & Billing deal its installments: count, done (paid), amount_total, paid_total, paid_count. Installments themselves are subtasks: search_issues with parent = the deal key lists them with their own fields and flags. Links (spec D131): frontmatter.links holds what you wrote (type, id — an issue key of this or another project of the company, or a release KEY/R-n for delivers); linked[] resolves each one live, same order: kind issue | release, project_key / project_name, readable (false = you cannot open that project or the target is gone — only the key is known, never guess the rest), and for a readable issue title, status, status_name, category, progress (100 when done else 0), for a readable release title, state, progress (% of its issues past the last gate; shipped = 100). computed also carries rollup fields (e.g. a goal's progress and linked) and fn: rice scores; flags may say on_track / at_risk / off_track for a Roadmap & Goals goal. Agent work context (D179): frontmatter.working / touches say what the assignee is doing and what it changes (working_at, working_by, working_by_agent); each readable linked issue also carries assignee, updated_at, working, working_at, touches and agent_live (an agent account called a tool on it in the last 10 minutes; last_tool_at) — read them before you change what they touch; a person's working older than a day may be stale. Before you START a card, get_issue_context gives all of this plus parent, siblings, comments and handoffs in one text.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| issue_key | Yes | Issue key `{PROJECT}-{n}`, e.g. `KJ-101`. | |
| project_key | Yes | Project key, e.g. `KJ`. 2–10 chars, uppercase letters and digits, starts with a letter. |