Skip to main content
GET
List user apps

Authorizations

api_key
string
header
required

API key for authentication. See the Authentication page for your API for details on how to get your key.

Path Parameters

workspace_id
string
required
user_id
string
required

User ID.

Query Parameters

limit
integer
default:50

Items per page. Max 50.

Required range: 1 <= x <= 50
cursor
string | null

Pagination cursor from previous response.

from
string | null

Start date in YYYY-MM-DD format for credit-consuming sort fields. Required if to is provided. Defaults to billing period start.

to
string | null

End date in YYYY-MM-DD format for credit-consuming sort fields. Required if from is provided. Defaults to current date.

sort
string | null

Sort field. Prefix with - for descending. Supported fields: app_name, created_at, created_by_email, owner_user_id, last_published, is_published, views_last_30d, active_users_last_30d, message_credits_consumed, integration_credits_consumed, total_credits_consumed.

search
string | null

Case-insensitive search over app name and creator email.

Maximum string length: 100
is_published
boolean | null

Filter to published (true) or unpublished (false) apps.

visibility
string | null

Filter by app visibility. Accepts private, workspace, public_with_login, public_without_login, or public.

active
boolean | null

Filter to apps with (true) or without (false) views in the last 30 days.

Response

Successful Response

Simplified user apps response - returns app IDs only.

app_ids
string[]
required

List of app IDs.

pagination
PaginationMetadata · object
required

Pagination metadata.