Is it possible to query /api/v2/analytics/users/summary with Premium App Service Account?

General Discussion
1

Is it possible to retrieve detailed user analytics via the Platform API when authenticating as a Genesys Cloud AppFoundry Premium App service account? We are building a custom reporting dashboard for our multi-tenant clients and need to pull real-time agent status and handle counts. The documentation suggests that service accounts require specific permissions, but we are hitting a wall with the analytics:users:view scope.

The issue manifests specifically when querying the /api/v2/analytics/users/summary endpoint. The request returns a 403 Forbidden response, even though the service account has been granted the Administrator role within the tenant. This is unexpected because manual API calls using a standard user token with the same role work perfectly. We suspect this might be a limitation related to how Premium Apps handle OAuth scopes for analytics resources, or perhaps a missing configuration in the AppFoundry portal.

Here is the sequence of events leading to the error:

  1. Generate an OAuth 2.0 client credentials token using the Premium App’s client ID and secret.
  2. Construct a GET request to /api/v2/analytics/users/summary with a date range of the last 24 hours.
  3. Include the Authorization: Bearer <token> header and the appropriate org_id.
  4. Receive a 403 Forbidden response with the message: “User does not have the required permission to perform this action.”

We have verified that the token is valid by calling /api/v2/users/me, which returns the service account details successfully. The problem is isolated to analytics endpoints. We are using the Python SDK version 12.0.1 for our integration logic. Has anyone successfully queried analytics APIs from a Premium App service account? If so, what additional steps or scopes are required beyond the standard administrator role? We need to ensure our architecture supports automated reporting without relying on user-bound tokens, which introduces complexity in our multi-tenant deployment.