Rensei docs
API ReferenceA2 A

List registered A2A agents for the org

List registered A2A agents for the org - Rensei REST API operation reference.

GET
/api/a2a/agents

Authorization

cookieAuth
wos-session<token>

WorkOS AuthKit browser session cookie.

In: cookie

Response Body

application/json

application/json

curl -X GET "https://example.com/api/a2a/agents"
{
  "agents": [
    {
      "id": "string",
      "orgId": "string",
      "url": "http://example.com",
      "trustLevel": "internal",
      "card": {
        "name": "string",
        "url": "http://example.com",
        "version": "string",
        "description": "string",
        "skills": [
          {}
        ]
      },
      "lastFetchedAt": "2019-08-24T14:15:22Z",
      "reachable": true,
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ]
}
{
  "error": "Session not found"
}

A2A (Agent-to-Agent) JSON-RPC endpoint (message/send, tasks/get, tasks/cancel).

A2A (Agent-to-Agent) JSON-RPC endpoint (message/send, tasks/get, tasks/cancel). - Rensei REST API operation reference.

Register a remote A2A agent

Discovers and persists an `AgentCard` from the supplied URL. The platform fetches `<url>/.well-known/agent-card.json` (or the URL itself if it returns a valid AgentCard) and stores the result. Validation / discovery errors are surfaced as 400. Auth: session cookie via `requireOrgAccess()` (cookie-only today).