get_revision
One version of an artefact by id, with its snapshot, the diff from the version before, who wrote it and why.
Return one version of a revisable artefact: the version number, the reason it was written, who wrote it and through what, the summary, the columns it changed, the diff from the version before and the full snapshot of the captured columns. Read it before you restore a version, so you and the person you act for know exactly what will come back, and to quote what a field said at a point in time.
Needs activity:read. An unknown id, a version of an artefact the token may not read, or any version read through a guest token is unknown rather than forbidden.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
It reads and never changes anything.
Arguments
revision_id*stringUUID of the version to fetch.
What it returns
{ "data": { "id": "d6e7f8a9-b0c1-4d2e-9f3a-4b5c6d7e8f90", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "revisable_type": "epic", "revisable_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d", "version": 1, "reason": "created", "actor_kind": "human", "author_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f", "author_name": "Nimal Fernando", "ai_feature": null, "restored_from_id": null, "restored_from_version": null, "summary": "Created", "changed_fields": [], "diff": null, "snapshot": { "title": "Loyalty tiers", "summary": null, "goal": "Reward the top fifth of members so they keep buying from the client.", "business_value": null, "hypothesis": null, "success_metrics": null, "owner_id": null, "priority": "should", "status": "draft", "starts_on": null, "due_on": null, "color": null }, "created_at": "2026-10-28T09:20:00+00:00" }}How it fails
RESOURCE_NOT_FOUNDunknown revision_id, a version of an artefact outside the token's scope or the person's visibility, or any version read through a guest token.
TOKEN_MISSING_ABILITYtoken lacks activity:read.
How is this guide?
Last updated on