Component workflow tokens

Note: Only active tokens are available for viewing. For each component workflow, only the latest token is shown.

1. Open the Component workflow tokens page: Click Settings and then click Component workflow tokens.

2. Click next to the component workflow, and then select {.} API endpoints.

A dialog box appears listing the following information:

• URL
• URL with token
• Token
• Request header(s)
• Request body
Note: Alternately, you can open the component workflow dialog from the Workflows page. Click (Options) next to the name of the component workflow, and then select {.} API endpoints.

See Component workflow tokens fields and selections for descriptions of each field on the page.

Component workflow tokens expire after one (1) year. You can refresh the life of an existing token. After the token is refreshed, you don't have to update the token where it's called.

1. Open the Component workflow tokens page: Click Settings and then click Component workflow tokens.

2. Click next to the component workflow, and then select {.} API endpoints. The Component workflow dialog is displayed.
   Note: Alternately, you can open the component workflow dialog from the Workflows page. Click (Options) next to the name of the component workflow, and then select {.} API endpoints.

3. Click next to the Token field, and select Refresh from the menu.

A message appears asking you to confirm the action.

4. Click Refresh to confirm.

Caution: Revoking a token causes external workflows and applications that start the component workflow to fail.

1. Open the Component workflow tokens page: Click Settings and then click Component workflow tokens.

2. Click next to the component workflow, and then select {.} API endpoints. The Component workflow dialog is displayed.
   Note: Alternately, you can open the component workflow dialog from the Workflows page. Click (Options) next to the name of the component workflow, and then select {.} API endpoints.

3. Click next to the Token field, and select Revoke from the menu.

A message appears asking you to confirm the action.

4. Click Revoke to confirm.

The token is revoked, invalidating its use in any API requests.

See Component workflow tokens fields and selections for descriptions fields on the page.

Component workflow tokens expire after one (1) year. The tokens of component workflows that are close to expiring or have already expired must be regenerated. Component workflows that are close to expiring will have a warning icon and workflows that have already expired will have a red error icon appearing against the workflow name to make them easily identifiable.

Caution: Regenerating a token replaces the current active token, which will be invalid in 24 hours. Regenerating a token that is revoked or expired will make the component workflow become available for external start again. Ensure to update the external workflows or applications that call the component workflow with the new token, or else they will fail.

1. Open the Component workflow tokens page: Click Settings and then click Component workflow tokens. Component workflows that are close to expiring will have a warning icon and workflows that have already expired will have a red error icon appearing against the workflow name to make them easily identifiable.

2. Click next to the component workflow, and then select {.} API endpoints. The Component workflow dialog is displayed.
   Note: Alternately, you can open the component workflow dialog from the Workflows page. Click (Options) next to the name of the component workflow, and then select {.} API endpoints.

3. Click next to the Token field and select Regenerate from the menu.
4. Click Regenerate to confirm.

The token becomes regenerated and the component workflow is valid for external start again.

5. Update the new regenerated token in your application to complete the process.

Caution: Deleting a token causes external workflows and applications that use it to start the component workflow to fail.

1. Open the Component workflow tokens page: Click Settings and then click Component workflow tokens.

2. Click next to the component workflow, and then select Delete.
3. Click Delete to confirm.

The token is deleted, invalidating its use in any API requests.