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

statusenum or nullOptional

Optional status filter. By default deleted users are omitted; pass status=deleted to audit soft-deleted users.

Allowed values:
qstring or nullOptional<=200 characters

Case-insensitive search over external_user_ref and display_name.

limitintegerOptional1-200Defaults to 50
cursorstring or nullOptional

Opaque pagination cursor returned as next_cursor.

Response

Successful Response

Errors

422
Unprocessable Entity Error