Create workflows using REST APIs
Identity Governance stores and saves workflow configurations in JSON format. You can manage the default workflow definitions for each access request type using REST APIs.
| For an example of a JSON file, refer to Examples of workflows. |
Steps to manage workflow definitions using REST API
-
Retrieve the current default workflow configurations for access request types using
/auto/orchestration/definition(GET).Save a copy of the default workflow for the access request type in case of an error with your updated workflow JSON file. -
Modify the default workflow to suit your needs.
-
Create a new default workflow definition for an access request type in a
draftstate using/auto/orchestration/definition?_action=create(POST).Each access request type can only contain one workflow definition in the
draftandpublishstates. One can exist in thedraftstate and thepublishstate. -
Validate the workflow definition before publishing using
/auto/orchestration/definition?_action=validate(POST). -
Publish the workflow definition from its
draftstate using/auto/orchestration/definition?_action=publish(POST).You cannot delete workflow definitions in the published state. -
Repeat steps 1-5 for each access request type desired.
Learn about workflow APIs in Workflows.