Skip to main content
GET
Get app analytics

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
app_id
string
required

App ID.

Query Parameters

from
string
required

Start date in YYYY-MM-DD format.

to
string
required

End date in YYYY-MM-DD format.

Response

Successful Response

Detailed analytics for a specific app

app_id
string
required

App identifier.

Example:

"app_abc123"

app_name
string
required

App name.

Example:

"Sales Dashboard"

unique_users
integer
required

Number of unique users.

Required range: x >= 0
Example:

156

total_views
integer
required

Total number of views.

Required range: x >= 0
Example:

2847

avg_session_duration_sec
number
required

Average session duration in seconds.

Required range: x >= 0
Example:

0

views_last_7d
integer
required

Views in last 7 days.

Required range: x >= 0
Example:

312

views_last_30d
integer
required

Views in last 30 days.

Required range: x >= 0
Example:

1205

active_users_last_7d
integer
required

Number of users who viewed the app in the last 7 days.

Required range: x >= 0
Example:

42

active_users_last_30d
integer
required

Number of users who viewed the app in the last 30 days.

Required range: x >= 0
Example:

89

message_credits_consumed
number
required

Message credits consumed by this app.

Required range: x >= 0
Example:

4250

integration_credits_consumed
number
required

Integration credits consumed by this app.

Required range: x >= 0
Example:

875

daily_views
Daily Views · object[]
required

Daily view counts.

Example:
is_published
boolean
required

Whether the app is live. The value is true when the app has been deployed and hasn't been unpublished since, and false when it was never deployed or was unpublished.

Example:

true

visibility
string
required

App visibility, such as "Public", "Public (with login)", "Workspace", or "Private".

Example:

"Public (with login)"

has_agent
boolean
required

Whether an AI agent is active in the app.

Example:

true

has_backend_function
boolean
required

Whether backend functions are enabled for the app.

Example:

false

has_authentication
boolean
required

Whether any auth method is enabled.

Example:

true

has_sso
boolean
required

Whether SSO is enabled.

Example:

false

has_secrets
boolean
required

Whether secrets are defined for the app.

Example:

true

last_published
string | null

Last publish date in YYYY-MM-DDTHH:MM:SSZ format. The date is kept after the app is unpublished, so read is_published for the current status.

Example:

"2025-01-10T14:30:00Z"

pending_publish_request
AppPendingPublishRequest · object | null

The most recent publish request waiting for approval, or null if the app has no pending request. When several members have requested a publish, this is the latest one.