Manage Your Profile
Manage Email Notifications
Manage Your Plan and Test Usage
Add and Remove Test Packs
Manage Payment and Invoice Settings
Create and Manage User Accounts
Create and Manage API Tokens
Manage Organisation Settings
Enable SAML Single Sign-On
Cancel Your Calibre Account
Export Your Calibre Data
Manage Your Profile
Manage Email Notifications
Manage Your Plan and Test Usage
Add and Remove Test Packs
Manage Payment and Invoice Settings
Create and Manage User Accounts
Create and Manage API Tokens
Manage Organisation Settings
Enable SAML Single Sign-On
Cancel Your Calibre Account
Export Your Calibre Data
API Tokens allow to safely and securely retrieve all of your Calibre performance monitoring information. They can be used as a method of authentication when using the CLI, Node.js API or the GraphQL API to export data or build automations.
There are two types of API Tokens in Calibre: Admin and Personal Access Tokens (PAT), which are available depending on the level of access to the organisation you are a member of:
Admin Tokens | Personal Access Tokens (PAT) | |
---|---|---|
Token permissions | All available permissions | Permissions scoped to the level of access of your account |
Who can create this token? | Administrators only | Anyone with a Calibre account |
Who can edit this token? | Administrators only | Administrators and token creators |
Who can revoke this token? | Administrators only | Administrators and token creators |
Which Teams can be accessed with this token? | All Teams in the Organisation | All Teams you are a member of |
Anyone with a Calibre account can create a Personal Access Token (PAT). Administrators and Users can select all permission options. Viewers can only select the Read Site option, as their account is read-only. Learn more about account types and levels of access to Calibre.
To create a Personal Access Token, click your avatar in the upper right-hand-side corner and then click the Personal Access Tokens link.
To create an Admin Token, click Manage in the upper right-hand-side corner and then navigate to the API tab. You will be able to add a new token by clicking Create a new API Access Token or Create a new Personal Access Token buttons.
To add a token:
Each token has access to a single Team and its Sites. The token permissions you can select depend on the type of your Calibre account. To save the token, click the Create token button at the bottom of the page.
You can edit API Tokens at any time by clicking the Edit link next to the selected token in the Manage → API tab and on the Personal Access Token page.
Make the desired changes and click the Save button to confirm.
To refresh an expired token, click the Edit button next to the corresponding token, and re-save it by clicking the Save button. It will be refreshed for the same amount of time as chosen in the Expires in field. You can also refresh tokens using the Refresh Token API.
You can revoke API Tokens at any time by clicking the Revoke link next to the selected token in the Manage → API tab and on the Personal Access Token page. Before we revoke the token, we will ask you to confirm your choice. The token will then be removed from the list.
As an administrator, you can quickly find an API Token using the search field in the upper right corner of the API tab. You can query by:
On both the API tab and the Personal Access Token page, you can sort the API Tokens table by clicking on the headings. For example, click on Expires at to see expired tokens.