Legacy A2A gateway - task snapshot dispatch (GET)

Backward-compatible legacy gateway. GET /v1/a2a?taskId=xxx looks up the task’s _agent_id and forwards to the per-agent endpoint GET /v1/agents/{agentId}/a2a?taskId=xxx. New clients should call the per-agent path directly.

GET /v1/a2a

Legacy A2A gateway - task snapshot dispatch (GET)

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/a2a \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "<string>",
  "contextId": "<string>",
  "status": {
    "state": "working",
    "timestamp": "<string>",
    "message": {}
  },
  "history": [
    {}
  ],
  "artifacts": [
    {}
  ],
  "metadata": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "terminal": true
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Query Parameters

taskId · string · required

Maximum string length: 128

Response

200

application/json

Task snapshot (forwarded from the per-agent endpoint).

A2A task record.

id · string

contextId · string

status · object

Hide child attributes

status. state · enum<string>

A2A task state.

Available options: working, completed, canceled, failed, input-required

status. timestamp · string

status. message · object

history · object[]

artifacts · object[]

metadata · object

createdAt · string<date-time>

terminal · boolean

True when state is completed, canceled, or failed.