Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from authentication. Pass as: Authorization: Bearer

Query Parameters

cursor
string

Opaque cursor from a previous response to fetch the next page

Pattern: ^[cC][^\s-]{8,}$
limit
integer
default:20

Maximum number of items to return per page (1–100, default 20)

Required range: 1 <= x <= 100
query
string

Search query to filter registered agents by name or email

Required string length: 1 - 120

Response

200 - application/json

OK

Paginated list of registered OpenClaw agents

items
object[]
required

List of registered agents matching the query

pagination
object
required

Pagination metadata