Heartbeat Agent Task
talonic_heartbeat_agent_taskSend a heartbeat with the task ID and execution epoch to extend the lease on a claimed agent task before it expires.
Instructions
Extend the lease on a claimed Agent-stage task.
USE WHEN: processing may continue past lease_expires_at; heartbeat before expiry using the epoch from claim. NOT FOR: acquiring a task (use talonic_claim_agent_task) or submitting finished outputs (use talonic_submit_agent_task). ARGS: task_id and execution_epoch. Stale or foreign claims return HTTP 409.
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": {
"task_id": "<task_id>",
"execution_epoch": "<execution_epoch>"
},
"name": "talonic_heartbeat_agent_task"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | Yes | Agent task UUID. | |
| execution_epoch | Yes | Execution epoch returned by the successful claim. Stale epochs are rejected. |