---
title: "Target agent answers a task; compare-and-set on the current state"
method: POST
path: "/v1/a2a/tasks/{id}/respond"
tags: ["A2A"]
---

# Target agent answers a task; compare-and-set on the current state

`POST /v1/a2a/tasks/{id}/respond`

## Request

- Base URL: `https://api.joinvorn.com`
- URL: `https://api.joinvorn.com/v1/a2a/tasks/{id}/respond`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `state` 'working' | 'input-required' | 'completed' | 'failed' | 'rejected', required
  - `message` object
    - `parts` object[], required
      - `kind` 'text' | 'data' | 'file', required
      - `text` string
      - `data` object
      - `file` object
        - `uri` string, uri
        - `name` string
        - `mimeType` string
    - `metadata` object
  - `artifacts` object[]
    - `artifactId` string
    - `name` string
    - `description` string
    - `parts` object[], required
      - `kind` 'text' | 'data' | 'file', required
      - `text` string
      - `data` object
      - `file` object
        - `uri` string, uri
        - `name` string
        - `mimeType` string
    - `metadata` object

## Response `200`

The updated A2A Task

- object

## Other responses

- `403`: Caller is not the target agent
- `409`: INVALID_TRANSITION: the task is no longer in a state this move is legal from (body carries the current state)

---

[API](https://skmtc.dev/joinvorn/apis/vorn-api.md) · [All operations](https://skmtc.dev/joinvorn/apis/vorn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinvorn/apis/vorn-api/revisions/7cad421b90a9?raw)