Skip to main content
Use these operations to list users in your Cortex workspace along with their profile metadata, and to retrieve their role assignments.

​
Required permissions

Your API token must have the View Roles permission.
Some built-in API key roles (VIWER, USER, and MANAGER) do not include View Roles. To call this endpoint with an API key, use an ADMIN key or create a new one and assign it a custom role that grants View Roles.

​
Operations

List users

GET /api/v1/users

List user role assignments

GET /api/v1/users/roles
Last modified on September 24, 2026