Deleting tokens using the REST API client

You can use the REST API client to delete tokens.

About this task

  • The Process Portal action policies govern security permissions for token management features. The ACTION_DELETE_TOKEN action policy must be configured to allow you to delete tokens and you must be a member of the default security group that is assigned to them to perform this action. See Configuration properties for Process Portal action policies.

Procedure

  1. Use the Process Inspector in the Process Admin Console to inspect the currently running process instances and select the instance containing orphaned tokens that you want to delete. Make a note of the process instance ID as well as the ID of the orphaned token, which will be shown in the execution call stack.
  2. To delete the token, in the REST API client, enter the following: :
    /rest/bpm/wle/v1/process/instance_ID?action=deleteToken&tokenId=
    token_ID[&resume=resume_value]
    The following identifies the parameters of the API:
    • instance_ID - the instance ID number of the process instance containing tokens to be moved
    • action - states the action to be taken (deleteToken)
    • token_ID - the token ID number of the token you need to delete
    • resume_value - the action used to resume the instance after deleting the token (set to "true" or "false"); the default value is "true"
  3. Press Enter to complete the delete action.
  4. On the Inspector tab of Process Designer, verify that the orphan token is now deleted.