---
title: "POST /agents/{agentId}/a2a/tasks/{taskId}/update"
method: POST
path: "/agents/{agentId}/a2a/tasks/{taskId}/update"
---

# POST /agents/{agentId}/a2a/tasks/{taskId}/update

`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

- `agentId` string, required: ID of the receiving agent that owns the task
- `taskId` string, required: ID of the task to update

## Request body

- object: Owner-driven A2A task status transition (the receiving agent reports working/completed/failed)
  - `status` 'working' | 'input_required' | 'completed' | 'failed', required: New task status. Terminal states (completed/failed/canceled) are immutable once reached.
  - `output` object: Task output payload (typically set when completing)
  - `error` object: Error details — only allowed when status is 'failed'
    - `code` string, required: Error code
    - `message` string, required: Error message
  - `message` string: Human-readable annotation recorded in the task history

## Response `200`

OK

- object: Full A2A task representation
  - `id` string, required: Unique task identifier
  - `agentId` string, required: ID of the receiving agent
  - `orgId` string, required: Organization that owns the receiving agent
  - `fromDid` string, required: Sender DID
  - `toDid` string, required: Receiver DID
  - `type` string, required: Task type
  - `status` 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled', required: Current status of the A2A task
  - `input` object, required: Task input payload
  - `output` object, nullable, required: Task output payload
  - `error` object, nullable, required: Error details if task failed
    - `code` string, required: Error code
    - `message` string, required: Error message
  - `history` object[], required: Status change history
    - `status` 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled', required: Current status of the A2A task
    - `message` string: Human-readable status message
    - `timestamp` string, date-time, required: ISO-8601 timestamp of the event
  - `createdAt` string, date-time, required: Task creation timestamp
  - `updatedAt` string, date-time, required: Last update timestamp

---

[API](https://skmtc.dev/useanima/apis/anima-api.md) · [All operations](https://skmtc.dev/useanima/apis/anima-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useanima/apis/anima-api/revisions/aaa148188980?raw)