Apps

Extend the decision-task lease

The lease never extends past the task's SLA deadline. A stale epoch is a 409 and journals nothing.

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

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/decision-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
run_idstring uuid required
app_idstring uuid required
status'available' | 'claimed' | 'submitted' | 'released' | 'failed' | 'timed_out' | 'cancelled' required
execution_epochinteger required
input_package_refstring

Where the frozen package lives; run in v1.

lease_secondsinteger
claimed_bystring nullable

The claimant: an API key id, or oauth:<client_id>:<user_id> for an OAuth session.

claimed_atstring date-time nullable
lease_expires_atstring date-time nullable
heartbeat_atstring date-time nullable
sla_deadline_atstring date-time required

Hard decision deadline; heartbeats never extend the lease past it.

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.