---
title: "Auth Users List"
method: GET
path: "/auth/users/"
tags: ["authentication"]
---

# Auth Users List

`GET /auth/users/`

Declare per-endpoint throttling configuration attributes for views.

Endpoints can inherit this mixin and set:
- endpoint_default_rate_limit_per_user_per_min: float | None

When set (not None), throttling will use ONLY this default RPM for the endpoint
without requiring API key / org attributes on the request. When unset, the
standard API key / organization / subscription limits apply.

## Headers

- `Authorization` string, required

## Response `200`

- User[]
  - `id` integer, required
  - `organization_role` OrganizationUserRole, required — Serializer for organization user roles. Security Note: Privilege escalation prevention is handled at the VIEW level (OrganizationMemberView), not here. This serializer is used by org admins to update member roles, so fields (role, permissions_override, ...) must remain writable. The view gates all writes on org admin via ``is_requiring_org_admin_for_write = True`` — a member cannot PATCH their own row to escalate. Any new write path using this serializer MUST apply the same admin gate, since the fields here are privilege-defining.
    - `id` integer, required
    - `access_level` integer, required
    - `user` UserRole, required
      - `id` integer, required
      - `email` string, required
      - `name` string, required
      - `username` string
      - `first_name` string
      - `last_name` string
      - `profile_color` string
      - `has_customized_password` boolean, required
    - `organization_name` string, required
    - `user_count` integer, required
    - `email` string
    - `role` 'member' | 'admin' | 'owner' | 'keywordsai_admin' | 'annotator' — * `member` - member * `admin` - admin * `owner` - owner * `keywordsai_admin` - keywordsai_admin * `annotator` - annotator
    - `pending` boolean
    - `hidden` boolean
    - `permissions_override` string[], nullable
    - `organization` integer, required
    - `project` string, nullable
  - `invitations` InvitationList[], nullable, required
    - `id` integer, required
    - `organization_name` string, required
    - `member_count` integer, required
    - `project` string, nullable
    - `email` string, email, required
    - `message` string
    - `code` string, uuid
    - `sent_at` string, date-time, required
    - `accepted_at` string, date-time, nullable
    - `role` 'member' | 'admin' | 'owner' | 'keywordsai_admin' | 'annotator' — * `member` - member * `admin` - admin * `owner` - owner * `keywordsai_admin` - keywordsai_admin * `annotator` - annotator
    - `organization` integer, required
  - `is_organization_admin` boolean, required
  - `time_range_types` TimeRangeType[], required
    - `name` string, required
    - `value` string, required
  - `is_being_impersonated` boolean, required
  - `is_superadmin` boolean, required
  - `last_login` string, date-time, nullable
  - `active_duration` string, nullable, required
  - `last_active` string, date-time, nullable
  - `user_unique_id` string, nullable, required
  - `created_at` string, date-time, required
  - `email` string, required
  - `placeholder` boolean
  - `name` string
  - `username` string
  - `first_name` string
  - `last_name` string
  - `sql_prompt_active` boolean
  - `sql_schema` unknown
  - `system_prompt_active` boolean
  - `system_prompt` unknown
  - `integration_time` integer
  - `onboarding_start` string, date-time
  - `onboarding_end` string, date-time, nullable
  - `onboarding_completed_at` string, date-time, nullable
  - `is_active` boolean, required
  - `status` 'active' | 'blocked', required — * `active` - Active * `blocked` - Blocked
  - `tokens_valid_after` string, date-time, nullable
  - `is_admin` boolean, required
  - `last_conversation` integer
  - `plans` string[]
  - `file_prompt` unknown
  - `user_file_index` string
  - `current_file` string
  - `payments` unknown[]
    - unknown
  - `display_properties` string[]
  - `request_log_sort_by` string
  - `time_range_type` string
  - `group_by` string
  - `request_log_filters` unknown
  - `last_request_log_export_start` string, date-time
  - `last_request_log_export_end` string, date-time
  - `exporting_logs` boolean
  - `dashboard_filters` unknown
  - `dashboard_selected_charts` string[]
  - `user_page_filters` unknown
  - `thread_filters` unknown
  - `thread_sort_by` string
  - `thread_group_by` string
  - `last_thread_export_start` string, date-time
  - `last_thread_export_end` string, date-time
  - `exporting_threads` boolean
  - `model_page_filters` unknown
  - `model_page_sort_by` string
  - `model_list_filters` unknown
  - `model_list_sort_by` string
  - `model_list_group_by` string
  - `customer_page_filters` unknown
  - `customer_page_sort_by` string
  - `customer_page_group_by` string
  - `last_editing_prompt_version` integer
  - `latest_frontend_version` string, required
  - `preference_settings` union
    - unknown
    - unknown
  - `theme` string
  - `profile_color` string
  - `curr_org` integer, nullable, required

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)