A2A

A2A Task Lifecycle Endpoint

Create, update, complete, and inspect task lifecycle records around rail.completed, receipt.verified, artifacts, and callbacks.

Returned objects

Call the surface and inspect returned state.

Create, update, complete, and inspect task lifecycle records around rail.completed, receipt.verified, artifacts, and callbacks.

Task fields

Task fields

a2a_task_id, task_state, rail_key, production_run_id, return_package_id, receipt_id, callback_event_id.

Modes

Modes

create_task, update_task, complete_task, read_recent_tasks.

Pass marker

Pass marker

task_state created, in_progress, or completed and record persisted.

Example

POST body

{
  "mode": "create_task",
  "rail_key": "packetops",
  "movement_amount_units": 1000,
  "movement_type": "transaction"
}