Service Account API permissions and authorization

Last updated: March 9, 2026

All API metrics are available through our API at https://api.span.app/docs-next. However, every metric exposure and API invocation is subject to a careful authorization strategy. Service Accounts require explicit permission grants to access these resources.

Solutions for Service Account Authorization

There are two ways to resolve Service Account permission issues:

Option 1 (Preferred): Add Service Account to Permission Group

Add the Service Account to an appropriate permission group that has the required access levels:

  1. Navigate to Settings > Permissions

  2. Select the appropriate permission group (e.g., managers or another relevant group)

  3. Add your Service Account to that group

Option 2: Use Personal Access Token

If option 1 is not possible, you may generate an access token for your own account to use your personal permissions:

  1. Go to Settings > Personal > Access Token

  2. Generate a new access token

  3. Use this token instead of the Service Account credentials

Choose the option that best fits your security requirements and organizational structure.