OAuth 2.0 API Tokens Page for Users
What are these new API tokens?
The new OAuth 2.0 API tokens are dynamic and provide improved security and control when compared to the legacy API tokens.
If you are a current user of the legacy API tokens created on the Access Tokens Page, please migrate to the new OAuth 2.0 API tokens. The legacy API tokens have been deprecated and new tokens created on the Access Tokens Page are not supported.
Note that the last date to migrate to the new API tokens is July 11, 2024.
On the OAuth 2.0 API Tokens page for users, you can create and manage API tokens for your Alteryx Analytics Cloud (AAC) workspace. To access the OAuth 2.0 API Tokens page for users, go to Profile menu > User Preferences > OAuth 2.0 API Tokens.
For more information on the AAC API, go to the API documentation.
If you are a workspace admin, you can manage users' API tokens on the OAuth 2.0 API Tokens Page for Admins.
Create an API Token
Select Generate from the OAuth 2.0 API Tokens page.
Enter a Name to describe the token.
Enter the token Lifetime in days. The token can last between 1 and 365 days.
Select Generate.
Copy both the Access Token and Refresh Token values and keep them in a secure location. You can't retrieve these token values after closing the API token dialog.
Access Token: Use Access Tokens to interact with the AAC API. Access tokens have a 1 hour lifespan. To refresh Access Tokens, invoke any AAC endpoint, or the token endpoint specifically.
Refresh Token: Use Refresh Tokens to fetch new Access Tokens when the previous Access Tokens expires. The Lifetime value you entered defines the lifespan of the Refresh token.
Select Close.
Note
You must create an API token for each workspace you want to interact with. You can't use an API token from 1 workspace to interact with another workspace.
Manage API Tokens
You can Disable or Delete API tokens that you've created. Note that once you Disable a token, you can't use it again.
To modify a single token, select the 3-dot menu next to the token.
To modify multiple tokens, check the box next to each token and then select Disable or Delete.
Important
If you Disable or Delete a token, this actions only affects the Refresh Token. The AAC API is still accessible until the Access Token expires, which can take up to 1 hour.