/o/apps/details

Endpoint

/o/apps/details

Overview

Return app detail block, resolved owner display name, and member lists for global admins, app admins, and app users.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

• App admin (or global admin) access to the target app is required.

Request Parameters

Parameter	Type	Required	Description
api_key	String	Yes (or use auth_token)	Dashboard API authentication key.
auth_token	String	Yes (or use api_key)	Dashboard auth token.
app_id	String	Yes	Target app ID.

Examples

Example 1: Read app details

/o/apps/details?api_key=YOUR_API_KEY&app_id=64b0ac10c2c3ce0012dd1001

Response

Success Response

{
  "app": {
    "owner": "Global Admin",
    "owner_id": "64afcc1a4f5f0f0012a11101",
    "created_at": 1717600000,
    "edited_at": 1717600100,
    "plugins": {},
    "last_data": 1717600200,
    "last_data_users": 1717600300
  },
  "global_admin": [
    {
      "full_name": "Global Admin",
      "username": "admin"
    }
  ],
  "admin": [],
  "user": []
}

Response Fields

Field	Type	Description
app	Object	Core app metadata block.
app.owner	String	Owner display name derived from member document or empty string.
app.owner_id	String	Owner member ID.
app.created_at	Number	App creation timestamp (seconds).
app.edited_at	Number	Last app edit timestamp (seconds).
app.plugins	Object	App-level plugin configuration object.
app.last_data	Number	Last app data timestamp stored on app record.
app.last_data_users	Number	Most recent app-user activity timestamp (lac) from app-user collection.
global_admin	Array of Objects	List of global admin members.
admin	Array of Objects	List of app admins for this app.
user	Array of Objects	List of app users for this app.

Error Responses

Status Code: 401 Unauthorized

{
  "result": "No app_id provided"
}

Status Code: 401 Unauthorized

{
  "result": "App does not exist"
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Details read	Valid app and permissions	Loads app, resolves owner display, loads member role lists, loads latest app-user activity.	Raw object { app, global_admin, admin, user }

Limitations

• Owner is returned as display text, not full owner profile object.

Related Endpoints

• Apps - App Read All
• Apps - App Read Mine
• Apps - App Read Plugins

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.apps	App metadata source	Reads target app document and plugin configuration.
countly.app_users{appId}	Activity recency lookup	Reads highest lac value to populate last_data_users.
countly.members	Owner and role list enrichment	Reads owner, global admin, app admin, and app user member records.