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

rsk_Bearer
AuthorizationBearer <token>

Rensei API key. Format: rsk_live_<random>. Generated in Settings or via POST /api/org/{orgId}/keys. Used by CLI (af), daemon, and programmatic integrations.

In: header

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 peer-discovery AgentCard

Fully unauthenticated (public) per the A2A spec. Two modes: - No query param: platform-level AgentCard (`scope='system'` rows). - `?org=<slug>`: per-org AgentCard (`scope='org'` cards with `trust.publish_to_a2a=true`). `Cache-Control: no-store` on all responses.

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).