/o/apps/all
Endpoint
/o/apps/all
Overview
Return all apps as packed app maps for admin and user scopes.
Authentication
Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.
Permissions
- Global admin permission 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. |
Examples
Example 1: Read all apps
/o/apps/all?api_key=YOUR_API_KEY
Response
Success Response
{
"admin_of": {
"64b0ac10c2c3ce0012dd1001": {
"_id": "64b0ac10c2c3ce0012dd1001",
"name": "My App",
"key": "3a4f9d...",
"country": "US",
"timezone": "Etc/UTC",
"category": "6",
"salt": ""
}
},
"user_of": {
"64b0ac10c2c3ce0012dd1001": {
"_id": "64b0ac10c2c3ce0012dd1001",
"name": "My App",
"key": "3a4f9d...",
"country": "US",
"timezone": "Etc/UTC",
"category": "6",
"salt": ""
}
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
admin_of | Object | Packed app map keyed by app ID. |
user_of | Object | Packed app map keyed by app ID. |
admin_of.[appId] | Object | Packed app record. |
user_of.[appId] | Object | Packed app record. |
salt | String | App salt or legacy checksum_salt fallback. |
Error Responses
Database read failure branch (still returns HTTP 200):
{
"admin_of": {},
"user_of": {}
}
Behavior
Behavior Modes
| Mode | Trigger | Processing Path | Response Shape |
|---|---|---|---|
| Standard read | Apps query succeeds | Loads all app documents and packs them into two ID-keyed maps. | Raw object { admin_of, user_of } |
| Fallback read | Apps query fails or returns no apps | Returns empty maps for both scopes. | Raw object { admin_of: {}, user_of: {} } |
Limitations
- Route is restricted to global admins.
- On query failure this handler still returns HTTP 200 with empty maps.
Related Endpoints
Implementation details
Database Collections
| Collection | Used for | Data touched by this endpoint |
|---|---|---|
countly.members | Authentication | Reads caller identity for global-admin validation. |
countly.apps | App list source | Reads all app documents and packs selected app fields for output. |