Actors

List users and agents

Changed on

List users and agents with the minimal fields needed to label them.

Each entry gives id, actor_type (user or agent), display name and active. Requires users:read. Results are scoped to the caller: org:admin lists everyone; anyone else lists only themselves and the agents they may see (their own, or with owner:agents:read their owner's agents). Cursor-paginated (cursor, limit). To label specific ids you already hold, use GET /actors/lookup.

get/actors

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /actors
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL /authorize, token URL /oauth/token)

Query parameters

cursorstring nullable

Opaque cursor from a previous page's next_cursor; omit for the first page.

Example:eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0=
limitinteger

Maximum number of actors to return (1-5000, default 1000).

Example:25

Response

Successful Response

has_moreboolean required

Whether more results exist after this page.

next_cursorstring nullable

Cursor for the next page; null when there are no more results.

Example response

{
  "data": [
    {
      "active": true,
      "actor_type": "user",
      "created_at": "2026-01-15T09:30:00Z",
      "id": "usr_6968b3987ee4c3ec0b4ee3b9",
      "name": "Ada Lovelace"
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ0IjogIjIwMjYtMDEtMTVUMDk6MzA6MDArMDA6MDAiLCAiaWQiOiAiM2YyYjhjMWUtN2Q0YS00ZTliLWE2YzUtMWQyZTNmNGE1YjZjIn0="
}

Changes