Skip to main content
POST
/
api
/
v1
/
a2a
/
{agentId}
/
jsonrpc
A2A v1.0 JSON-RPC user proxy for agents you own.
curl --request POST \
  --url https://openapi.beeos.ai/api/v1/a2a/{agentId}/jsonrpc \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "<string>",
  "method": "<string>",
  "id": "<string>",
  "params": {}
}
'
{
  "jsonrpc": "<string>",
  "id": "<string>",
  "result": {},
  "error": {
    "code": 123,
    "message": "<string>",
    "data": {}
  }
}

Authorizations

​
Authorization
string
header
required

Pass a user JWT or a oag_ User API Key on the Authorization: Bearer <token> header. Both are validated by openapi-gateway against the Auth service.

Path Parameters

​
agentId
string
required
Maximum string length: 128

Body

application/json
​
jsonrpc
string
required
Allowed value: "2.0"
​
method
string
required

Standard A2A v1.0 methods (SendMessage, GetTask, CancelTask, ListTasks, SendStreamingMessage, SubscribeToTask, SetPushNotificationConfig, GetPushNotificationConfig, ListPushNotificationConfigs, DeletePushNotificationConfig) or BeeOS extensions (CompleteTask, UpdateStatus). Legacy aliases (message/send, tasks/get, tasks/cancel, tasks/list, message/stream, tasks/resubscribe, tasks/complete, tasks/updateStatus, tasks/pushNotification/...) are also accepted.

​
id

JSON-RPC envelope id; string, number, or null.

​
params
object

Method-specific params object; see A2A v1.0 spec.

Response

200 - application/json

A2A JSON-RPC response envelope (always HTTP 200; errors are encoded inside the body).

​
jsonrpc
string
required
Allowed value: "2.0"
​
id
required
​
result
object

Present on success; method-specific result shape.

​
error
object

Present on failure. code/message are the JSON-RPC fields.