List Users

Rate Limit

Limit TypeValue
Requests per second10

If you exceed these limits, you will receive a 429 Rate Limit Exceeded response.

API Details

  • Returns active users (including human and AI agents) for the authenticated brand.
  • Results are ordered by Regal user ID. Use nextCursor from the response to retrieve the next set of results.
  • Filters combine with AND across email, skills, teams, queues, and custom attributes.
  • Multiple queue values are treated as OR: users eligible for any listed queue are returned.
  • skills, teams, queues, and customAttributes must be JSON-encoded query string values.

Query Params
string
number
string
string
string
string
string
Headers
string
required
string
Defaults to application/json
Responses

400

Invalid query parameters, unknown team, or unknown queue.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json