post/agents/{agentId}/a2a/tasks/{taskId}/update

Request

  • Base URL: https://api.useanima.sh/v1
  • URL: https://api.useanima.sh/v1/agents/{agentId}/a2a/tasks/{taskId}/update
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

agentIdstring required

ID of the receiving agent that owns the task

taskIdstring required

ID of the task to update

Request body

status'working' | 'input_required' | 'completed' | 'failed' required

New task status. Terminal states (completed/failed/canceled) are immutable once reached.

outputobject

Task output payload (typically set when completing)

messagestring

Human-readable annotation recorded in the task history

Response

OK

idstring required

Unique task identifier

agentIdstring required

ID of the receiving agent

orgIdstring required

Organization that owns the receiving agent

fromDidstring required

Sender DID

toDidstring required

Receiver DID

typestring required

Task type

status'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled' required

Current status of the A2A task

inputobject required

Task input payload

outputobject nullable required

Task output payload

createdAtstring date-time required

Task creation timestamp

updatedAtstring date-time required

Last update timestamp

Changes

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