Apps and tokens
Administrator or Developer role required. For information about user roles, see User roles.
The Apps and tokens page lists tokens for accessing the Nintex Automation Cloud API. Apps can request tokens that are used for API requests to access all tasks, instances and workflows in your Nintex Automation Cloud tenant. You can use personal access tokens to make API requests to access what you have permissions for in your Nintex Automation Cloud tenant.
You can perform the following actions in this page:
- Add, view, disable, activate, and delete apps.
- Add, view, revoke, and delete personal access tokens.
Access the Apps and tokens page
-
On the top navigation bar, click Settings.
The License and subscription page appears with options on the left.
-
On the left, click Apps and tokens.
Manage apps
-
Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
Click Add app.
- In the Add app section, type an App name and a Description.
-
Click Add.
The new app is added with Active status and a green checkmark briefly appears in the newly added app.
-
Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Apps section, click and then select View for the required app.
The Client ID and Client Secret are displayed for the selected app.
Note: Any API calls using that app's credentials will fail once the app is disabled.
- Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Apps section, click and then select Disable for the required app.
The app's Status is updated to Disabled.
- Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Apps section, click and then select Activate for the required app.
The app's Status is updated to Active.
Note: Any API calls using that app's credentials will fail once the app is deleted.
- Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Apps section, click and then select Delete for the required app.
The deleted app is removed from the Apps section.
Manage personal access tokens
Tokens automatically expire 12 months from the date of creation.
-
Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the personal access tokens section, click Add token.
- In the Create new token section, type a Name.
-
Click Create.
The new token is added to the personal access tokens section and a green checkmark briefly appears to the left of the token. The expiration date is 12 months from the date of creation.
-
Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Personal access tokens section, click and then select View for the required token.
The selected personal access token identifier is displayed.
Revoke a token if you want to deny access to your Nintex Automation Cloud tenant with that token.
Note: Revoke tokens with care. API requests using revoked tokens will fail.
-
Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Personal access tokens section, click and then select Revoke for the required token.
-
Click Yes to confirm.
The status of the selected token is updated to Revoked.
Delete a token to remove it from your Nintex Automation Cloud tenant. You can only delete a token if it has expired or been revoked.
- Access the Apps and tokens page: Click Settings and then click Apps and tokens.
-
In the Personal access tokens section, click and then select Delete for the required token.
-
Click Yes to confirm.
The deleted token is removed from the personal access tokens section.
Section | Selection (or column or field) | Description |
---|---|---|
Apps | Add app |
Displays the Add app section with the following fields and buttons:
|
Created by | The name of the user who added the app. | |
Status |
Displays the following app statuses:
|
|
(Options) |
Lists the following selections.
|
|
Personal access tokens |
Create new |
Displays the Create new token section with the following fields.
Click Create to save your changes. |
Status |
Displays the following token statuses:
|
|
Created by |
User name of the person who created the token. |
|
Expires |
Expiration date of the token. |
|
(Options) |
Lists the following selections.
|