List Organization Users (Admin)

GET /api/v1/orgs/me/users

Retrieves a paginated list of all users belonging to the authenticated user's organization. Requires admin role.

Query parameters

  • limit integer

    Number of users per page

    Default value is 20.

  • offset integer

    Offset for pagination

    Default value is 0.

Responses

  • 200 application/json

    List of users in the organization

    Hide response attributes Show response attributes object
    • created_at string Required
    • email string Required
    • first_name string Required
    • id integer Required
    • last_login_at string Required
    • last_name string Required
    • organization_id integer Required
    • role string Required
    • updated_at string Required
  • 401 application/json

    Unauthorized (JWT invalid/missing or Org ID not found)

    Hide response attribute Show response attribute object
    • * string Additional properties
  • 403 application/json

    Forbidden (User does not have admin role)" // Assuming RoleRequired middleware handles this

    Hide response attribute Show response attribute object
    • * string Additional properties
  • 500 application/json

    Failed to get users

    Hide response attribute Show response attribute object
    • * string Additional properties
GET /api/v1/orgs/me/users
curl \
 --request GET 'http://api.example.com/api/v1/orgs/me/users' \
 --header "Authorization: $API_KEY"
Response examples (200)
[
  {
    "created_at": "string",
    "email": "string",
    "first_name": "string",
    "id": 42,
    "last_login_at": "string",
    "last_name": "string",
    "organization_id": 42,
    "role": "string",
    "updated_at": "string"
  }
]
Response examples (401)
{
  "additionalProperty1": "string",
  "additionalProperty2": "string"
}
Response examples (403)
{
  "additionalProperty1": "string",
  "additionalProperty2": "string"
}
Response examples (500)
{
  "additionalProperty1": "string",
  "additionalProperty2": "string"
}