Skip to content

Personal Access Tokens

A personal access token lets an application or an AI client call CxReports as you, through the API or the MCP server. It never has more permissions than you.

Create a token

Tokens are created from your user menu and belong to your account:

  1. Open the user menu in the top-right corner and select Personal Access Token.
  2. Select New token.
  3. Enter a Token name, choose when the token Expires after, and, if offered, select its Applications.
  4. Select Generate, then copy the token.

The token is shown only once. Store it securely, for example in a secrets manager or an environment variable, and never commit it to a repository.

A token cannot be edited. To change its applications or expiry, delete it and create a new one. Requests with a deleted or expired token are refused with 401 Unauthorized.

Applications

A token can only reach the applications that were selected when it was created. Requests to the others are refused as if you had no permission there. Administration and shared workspace data (data sources, parameters, files, workspace settings) are always included.

Application What the token reaches
Reports Reports, templates, themes, dictionaries and report generation jobs: everything the Reports section of a role controls
Portals Portals, portal designs and portal themes

Select only the applications the token is for.

A token limited to some applications cannot create Nonce tokens, or a new token for applications it does not cover itself.

Permissions

A token acts as the user who created it. It reaches the same workspaces as you, with the access your roles and resource permissions give you, checked on every request.