List Admin Agents

Paginated list of all agents with registry identity and override summary (admin only).

Authorization

bearerAuth

AuthorizationBearer <token>

Authentication required for all endpoints. Supports Better Auth user credentials, dedicated coworker bearer API keys (coworker_), and the orchestrator service bearer (ORCHESTRATOR_SERVICE_TOKEN).

In: header

Query Parameters

cursor?string

Cursor for pagination (ID of the last item from previous page)

limit?integer

Number of items to return (max 100)

Default20

Range1 <= value <= 100

q?string

Optional search on registry name, blockchain identifier, or override name

Length1 <= length

status?string

Filter agents by registry status (omit for all)

Value in"ONLINE" | "OFFLINE" | "DEREGISTERED" | "INVALID"

sortBy?string

Column to sort the admin agent list by

Default"createdAt"

Value in"displayName" | "registryName" | "hasOverride" | "status" | "createdAt"

sortOrder?string

Sort direction for the admin agent list

Default"desc"

Value in"asc" | "desc"

Response Body

`application/json`

curl -X GET "https://loading/v1/admin/agents"

{
  "data": [
    {
      "id": "string",
      "blockchainIdentifier": "string",
      "registryName": "string",
      "hasOverride": true,
      "displayName": "string",
      "displayImage": "string",
      "status": "ONLINE",
      "isShown": true,
      "createdAt": "2021-01-01T00:00:00.000Z",
      "updatedAt": "2021-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "string",
    "pagination": {
      "cursor": "cmg4zknxt0000l404yn4li0kp",
      "limit": 20,
      "total": 100,
      "nextCursor": "cmi4gmksz000104l8wps8p7fp"
    }
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

{
  "error": "Unauthorized",
  "message": "Authentication required",
  "kind": "organization_not_found",
  "meta": {
    "timestamp": "2021-01-01T00:00:00.000Z",
    "requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
    "path": "/v1/agents",
    "method": "GET"
  }
}

List Admin Agents

Authorization

Query Parameters

Response Body

200application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`