Skip to main content

/o/apps/mine

Endpoint​

/o/apps/mine

Overview​

Return apps accessible to the authenticated user, split by admin scope and user scope.

Authentication​

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

Permissions​

  • Any authenticated dashboard user.

Request Parameters​

ParameterTypeRequiredDescription
api_keyStringYes (or use auth_token)Dashboard API authentication key.
auth_tokenStringYes (or use api_key)Dashboard auth token.

Examples​

Example 1: Read current user app scopes​

/o/apps/mine?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": {}
}

Response Fields​

FieldTypeDescription
admin_ofObjectPacked app map for apps where user has admin-level access.
user_ofObjectPacked app map for apps where user has user-level access.
admin_of.[appId]ObjectPacked app record for admin scope.
user_of.[appId]ObjectPacked app record for user scope.

Error Responses​

This endpoint does not define custom non-auth business errors. Authentication/authorization layer errors apply.

Behavior​

Behavior Modes​

ModeTriggerProcessing PathResponse Shape
Global admin modeCaller is global adminDelegates to full app list behavior.Raw object { admin_of, user_of }
Scoped member modeCaller is not global adminLoads apps from member admin_of and user_of scopes and packs results.Raw object { admin_of, user_of }

Limitations​

  • Response is map-based, not paginated arrays.
Implementation details

Database Collections

CollectionUsed forData touched by this endpoint
countly.membersAuthentication and app scope resolutionReads caller member permissions and app scope lists.
countly.appsApp metadata sourceReads app documents for IDs allowed to the caller.