Reten Docs
Users

List Tenant Users

Get a paginated list of users in the current tenant.

GET /api/user/tenant-users

Returns a paginated list of users associated with the current tenant.

Auth: Required — VIEW_USERS permission

Headers

HeaderRequiredValue
AuthorizationYesBearer <access_token>
x-tenant-idYesTenant UUID

Query Parameters

ParameterTypeDefaultDescription
pagenumber1Page number
limitnumber20Items per page

Example

curl "https://api.reten.ai/api/user/tenant-users?page=1&limit=10" \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/user/tenant-users',
  {
    params: { page: 1, limit: 10 },
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

Response 200 OK

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "admin@example.com",
      "firstName": "Admin",
      "lastName": "User",
      "roles": ["SUPER_ADMIN"]
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1,
    "totalPages": 1
  }
}