Agent Tasks

Claim or reclaim an expired Agent task lease

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

Request

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

Path parameters

idstring uuid required

Response

Claimed task payload with a new execution epoch and lease expiry.

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
input_snapshotobject required

Immutable latest-cell snapshot captured when the document reached the Agent (via MCP) stage.

instructionsstring nullable
timeout_fallthrough'hold' | 'skip' | 'route_to_review' required

Changes

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