List external users
List this app's managed end-users.
This is the runtime-key view a developer dashboard or coding agent can use
after users arrive through ``POST /v1/sessions`` or explicit upserts. It is
app-scoped, returns the developer-controlled ``external_user_ref`` as the
stable identifier, and includes budget/usage/session summary fields. It does
not expose raw conversations; use session/event APIs for a specific user's
sessions.
Authentication
AuthorizationBearer
LoreOS API key, sent as Authorization: Bearer <key>.
Query parameters
status
Optional status filter. By default deleted users are omitted; pass status=deleted to audit soft-deleted users.
Allowed values:
q
Case-insensitive search over external_user_ref and display_name.
limit
cursor
Opaque pagination cursor returned as next_cursor.
Response
Successful Response
Errors
422
Unprocessable Entity Error