Agent Tasks

Extend the current Agent task lease

post/v1/agent-tasks/{id}/heartbeat

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/agent-tasks/{id}/heartbeat
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Request body

execution_epochinteger required

Response

Updated task metadata.

idstring uuid required
customer_idstring uuid required
pipeline_idstring uuid required
grain'document' | 'product' required

document = one parked document at an Agent (via MCP) rail stage; product = one composed record at the post-assembly Agentic Review stage.

pipeline_document_idstring uuid nullable required

Set on document-grain tasks only.

document_idstring uuid nullable required

Set on document-grain tasks only.

record_idstring uuid nullable required

The composed record under review; set on product-grain tasks only.

stage_idstring required
phase_indexinteger required
status'available' | 'claimed' | 'submitted' | 'timed_out' | 'cancelled' required
execution_epochinteger required
claimed_atstring date-time nullable
lease_expires_atstring date-time nullable
timeout_atstring date-time required
submitted_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.