NylorunDocsBeta
Runtime APISessionsA2A

Call an agent over A2A

POST
/v1/a2a/agents/{agentId}

A2A 1.0 JSON-RPC, for a subject: SendMessage (blocking up to 5 minutes, or returnImmediately), GetTask and CancelTask. A context is one session per subject, agent and contextId; a task is one turn. JSON-RPC errors are answered with 200; limits, scopes and unavailable streams stay HTTP errors.

Authorization

headerAuthorizationBearer <token>

An application key of the Tenant (PUT /v1/tenant/keys/{keyId}), or Studio's key, derived from the admin key. With Nylorun-Subject and Nylorun-Scopes, it acts for that person, narrowed to those scopes. Never accepted from a browser (Origin).

Path Parameters

agentId*string

Query Parameters

A2A-Version?string

Or the A2A-Version header: 1.0

Header Parameters

Nylorun-Protocol*string

The protocol version, 8

Nylorun-Subject?string

The person an application key acts for

Nylorun-Scopes?string

The subject's space-separated scopes; required with a subject

Request Body

application/json
  1. body
jsonrpc*"2.0"
Value in"2.0"
id?string|number|null
method*string

SendMessage, GetTask or CancelTask; others answer their A2A error

params?unknown
[key: string]?unknown

Response Body

The JSON-RPC answer: a result, or an A2A error

application/json
  1. response
jsonrpc*"2.0"
Value in"2.0"
id*string|number|null
result?unknown
error?
[key: string]?unknown
curl -X POST "https://example.com/v1/a2a/agents/string" \  -H "Nylorun-Protocol: string" \  -H "Content-Type: application/json" \  -d '{    "jsonrpc": "2.0",    "method": "string",    "property1": null,    "property2": null  }'
{  "jsonrpc": "2.0",  "id": "string",  "result": null,  "error": {    "code": 0,    "message": "string",    "data": null  },  "property1": null,  "property2": null}

Get an agent's A2A card GET

Previous Page

Create or find a sandbox PUT

Creates the sandbox within the Tenant's limits, or answers the one with this id, so get-or-create is one call. Its spec is fixed once it exists; labels, when sent, replace its labels. Kind `pod` needs sandbox pods (`nylorun sandbox enable`): it is created at once, and a PUT on an existing pod sandbox starts it again when it was stopped, or revives it with a longer `lifecycle.ttl`.