Skip to main content
POST
A2A JSON-RPC binding

Authorizations

Authorization
string
header
required

OAuth 2.0 / OIDC bearer token.

Tenant-Name
string
header
required

The tenant the request operates within.

Headers

A2A-Version
string
default:1.0

A2A protocol version in Major.Minor form (A2A §3.6). Optional; defaults to 1.0 when absent. This surface implements 1.0 only. Patch versions MUST NOT be sent and are not considered during negotiation.

Pattern: ^\d+\.\d+$

Path Parameters

agentId
string<agent-id>
required

Agent identifier (prefixed UUIDv7). Agent identifier. Accepts agt.<uuidv7> or a bare UUIDv7 on input; always returned prefixed.

Pattern: ^(agt\.)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"agt.0192f4c8-2c5a-7b3e-9f1a-3c8d6e2b7a40"

Body

application/json

A single JSON-RPC 2.0 request envelope.

A JSON-RPC 2.0 request envelope.

jsonrpc
any
required

JSON-RPC protocol version; always 2.0.

id
required
Example:

"msg-001"

method
enum<string>
required

JSON-RPC method name (PascalCase on the wire).

Available options:
SendMessage,
SendStreamingMessage,
GetTask,
ListTasks,
CancelTask,
SubscribeToTask
Example:

"SendMessage"

params
object

JSON-RPC params object.

Example:

Response

A single JSON-RPC response (non-streaming methods), or an text/event-stream for the streaming methods (SendStreamingMessage, SubscribeToTask) where each event's data is a JSON-encoded JSONRPCResponse.

A JSON-RPC 2.0 response envelope.

jsonrpc
any
required

JSON-RPC protocol version; always 2.0.

id
required
Example:

"msg-001"

result
object

JSON-RPC result object (present on success).

Example:
error
object

JSON-RPC error object (present on failure).

Example: