get_canned_reply
Fetch one saved support reply by UUID, looked up within its project.
Read a single snippet — the full body, its shortcut and its position — when you already know which one. Same row list_canned_replies returns, so reading one and reading all agree field for field.
Saved replies exist only beneath a project, so the tool takes both ids and
resolves the snippet within that project. A snippet id that belongs to a
different project is RESOURCE_NOT_FOUND here even if the token could see
that other project.
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
project_id*stringUUID of the project the snippet belongs to.
canned_reply_id*stringUUID of the saved reply to fetch.
What it returns
{ "data": { "id": "5d2f8a71-3c9e-4b06-a8f4-1e7c9d2b6a35", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "title": "Opening hours", "body": "We answer between 9 and 5, Monday to Friday. Anything sent outside that gets a reply the next working morning.", "shortcut": "hours", "sort_order": 1, "created_at": "2026-06-02T09:14:02+00:00", "updated_at": "2026-06-02T09:14:02+00:00" }}updated_at equal to created_at means the snippet has never been edited.
How it fails
RESOURCE_NOT_FOUNDproject_id names a project the token cannot see, or canned_reply_id is unknown, deleted, or belongs to another project.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks support-canned-reply:view-any.
How is this guide?
Last updated on