Rensei docs
API ReferenceA2 A

Get a registered A2A agent

Get a registered A2A agent - Rensei REST API operation reference.

GET
/api/a2a/agents/{id}

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

Path Parameters

id*string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/a2a/agents/string"
{
  "agent": {
    "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"
}
{
  "error": "Session not found"
}

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

Update agent trust level

Update agent trust level - Rensei REST API operation reference.