preview_description_update
REQUIRED first step of every card or epic description edit: validates the block operations and returns the server-computed consequences plus the preview_token that update_description requires. Nothing is modified. Content is AgileHero Markup (AHM, description surface: no tables, colors, alignment, discussions, or file attachments) — read get_ahm_spec first; block ids and document_version come from get_card / get_epic.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"resource_type": "<resource_type>",
"id": "<id>",
"document_version": "<document_version>",
"operations": "<operations>"
},
"name": "preview_description_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Card or epic uid | |
| operations | Yes | Applied in order against the evolving description | |
| resource_type | Yes | ||
| document_version | Yes | From get_card / get_epic |