Get 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.

You act with exactly the rights of the user who owns this token; a project you cannot see returns not_found.