v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01144108427.9 KB
a2a

A2A Jsonrpc

Serve the A2A JSON-RPC surface (message/send, message/stream, tasks/get, tasks/resubscribe) for an agent flow.

Gated like the card route; apikey-folder flows additionally require a valid owner key (401). The flow runs as its owner. Returns the SDK's JSON-RPC response (HTTP 200 even for JSON-RPC-level errors). No DbSession dependency here: holding a session open across the run would fight the v2 surface's lock-avoidance design, and the gate/run resolve from flow_id via short self-managed sessions.

post/api/v1/a2a/{flow_id}/jsonrpc

Path parameters

flow_idstring uuid required

Response

Successful Response

{"stackTrail":"paths:/api/v1/a2a/{flow_id}/jsonrpc:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}