Create a token
- Go to API tokens and select New token.
- Give it a Name that says what uses it, such as Facilities BI export.
-
Tick only the Scopes it needs:
The other scopes listed (notification channels, reports) are reserved for endpoints not yet in the API.
- Choose when it Expires: 30 days, 90 days (the default) or 1 year. Never (not recommended) is also available.
- Select Create token, then copy the token.
Keep track of tokens
Tokens start withavb_, and the integration sends one as Authorization: Bearer <token>. The list is split into Active and Revoked tokens. It shows each token’s prefix (such as avb_1a2b3c4d…), how many scopes it has, who created it, when and from where it was last used, and when it expires or was revoked, or no expiry. Expired tokens are marked expired. A token that has never been used, or hasn’t been used for months, may be safe to revoke.
Revoke a token
Select the token’s revoke icon, then Revoke token. The integration using it stops working immediately. The token stays in the list, and its past activity in the audit log, so it can still be traced. A revoked or expired token is deleted 90 days after it was revoked or expired. Active tokens are never deleted. To rotate a token without downtime, create the new one, update the integration, then revoke the old one.Updated 06 Nov 2026 14:07 · page 56187cd