---
title: "List All Users"
method: GET
path: "/manage/users"
tags: ["public"]
---

# List All Users

`GET /manage/users`

## Query parameters

- `q` string, nullable
- `accepted_page` integer, nullable
- `slack_users_page` integer, nullable
- `invited_page` integer, nullable
- `include_api_keys` boolean

## Response `200`

Successful Response

- AllUsersResponse
  - `accepted` FullUserSnapshot[], required
    - `id` string, uuid, required
    - `email` string, required
    - `role` 'limited' | 'basic' | 'admin' | 'curator' | 'global_curator' | 'slack_user' | 'ext_perm_user', required — User roles - Basic can't perform any admin actions - Admin can perform all admin actions - Curator can perform admin actions for groups they are curators of - Global Curator can perform admin actions for all groups they are a member of - Limited can access a limited set of basic api endpoints - Slack are users that have used onyx via slack but dont have a web login - External permissioned users that have been picked up during the external permissions sync process but don't have a web login
    - `is_active` boolean, required
    - `password_configured` boolean, required
  - `invited` InvitedUserSnapshot[], required
    - `email` string, required
  - `slack_users` FullUserSnapshot[], required
    - `id` string, uuid, required
    - `email` string, required
    - `role` 'limited' | 'basic' | 'admin' | 'curator' | 'global_curator' | 'slack_user' | 'ext_perm_user', required — User roles - Basic can't perform any admin actions - Admin can perform all admin actions - Curator can perform admin actions for groups they are curators of - Global Curator can perform admin actions for all groups they are a member of - Limited can access a limited set of basic api endpoints - Slack are users that have used onyx via slack but dont have a web login - External permissioned users that have been picked up during the external permissions sync process but don't have a web login
    - `is_active` boolean, required
    - `password_configured` boolean, required
  - `accepted_pages` integer, required
  - `invited_pages` integer, required
  - `slack_users_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/onyx-dot-app/apis/agents-api.md) · [All operations](https://skmtc.net/onyx-dot-app/apis/agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onyx-dot-app/agents-api/versions/ea131344b29e/schema)