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

# List Users

`GET /manage/users`

## Request

- Base URL: `https://api.agent4.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.agent4.io/manage/users`
- Auth: none declared

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `q` string, nullable
- `sort` string

## Response `200`

Successful Response

- UserPage
  - `items` UserOut[], required
    - `id` string, required
    - `external_user_id` string, required
    - `pref_name` string, nullable
    - `created_at` string, date-time, required
    - `space_count` integer
    - `session_count` integer
    - `document_count` integer
    - `auth` string
    - `email` string, nullable
    - `email_verified` boolean, nullable
    - `tokens_24h` integer
  - `next_cursor` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agent4/apis/chatagent-platform.md) · [All operations](https://skmtc.dev/agent4/apis/chatagent-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/agent4/apis/chatagent-platform/revisions/18e58f082ce3?raw)