What's New

Learn about new and changed endpoints for the Oracle Cloud Infrastructure Process Automation REST API.

June 2024

REST API Category	Changes in REST API
Decision Applications	The following designtime decision application APIs have been added: Activate an Application Clone an Application Create or Import an Application Deactivate an Application Delete All Versions of an Application Delete an Application by Name and Version Export an Application Get an Application List Applications by Name List Decision Applications Version an Application Create a Snapshot Delete a Snapshot Delete Snapshots Get a Snapshot List Snapshots
Decisions	The following runtime decision APIs have been added: Get Application Details Get the OpenAPI Specification of a Decision Service Send Message to Process Instance Get the Version of an Application List Applications List Decision Services of an Application Version List Versions of an Application

February 2024

REST API Category	Changes in REST API
Messages	The Send Message to Process Instance API has been added.
User Configurations	Workspace users can create multiple records of their leave periods so that their assigned tasks can be automatically reassigned to other users or roles during their absence. The following Out Of Office related APIs have been added: Creates Out Of Office Record Deletes Out Of Office Record Get Out Of Office Record List Out Of Office Record Update Out of Office Record

October 2023

REST API Category	Changes in REST API
Applications/Connectors	The following new APIs have been added: Associate a Global Credential with a Connector Get the Associated Global Credential of a Connector Get List of Global Credentials for a Connector

June 2023

The documentation in this guide has been reorganized and grouped according to resources.

April 2023

REST API Category	Changes in REST API
Alter Flow	Process owners and administrators with MANAGE permission on the process application can change the course of a running process instance that has encountered a problem and needs manual intervention. The following new APIs have been added: List Active Activity IDs of an Instance List Target Activities of an Instance Note: You can use these APIs only on structured processes. While altering the flow, ensure that all the related process instances are not be in terminal state such as COMPLETED or TERMINATED. To change the course of a running process, do one of the following: Move the process instance forward or backward to any eligible activity in the flow. Before performing this action, ensure that the process instance is in a SUSPENDED state. Modify the existing data attributes of the process instance and retry the current activity.
Processes	A new ALTER_FLOW property action has been added to the Request Body schema of the Perform an Action on Process Instance API. The following new APIs have been added: List Attribute Values of an Instance List Attributes of an Instance List Data Objects of Sub-process Activity Get Data Object Value of Sub-process Activity Update Attribute Values of an Instance Update Data Object of a Sub-process Activity
Adhoc Tasks	You can now create and assign adhoc human tasks in runtime environment without the prerequisite of modeling and deploying process applications. A typical use case in a document management system is when a document is uploaded, you can create an adhoc task and assign to a user for review comments. Adhoc tasks are not associated with any structured or dynamic process. You can define possible outcomes, and include information such as due date, priority, title, summary, and assignee details. After it is created, the assignee is notified, and the task appears in the assignee's list of tasks. The following new APIs have been added: Add Members to an Adhoc Task Create an Adhoc Task Delete a Member of an Adhoc Task Get All Members of an Adhoc Task Get Member Details of an Adhoc Task Update/Delete Members of an Adhoc Task
Members	Members are dynamically assigned users to a specific process instance. You can add, delete or update members in a process instance. Members do not require roles to work in an instance. You cannot add members to child instances and child adhoc tasks. You can give any of the available permissions like INSPECT, READ, USE or MANAGE to members so that they can work in the assigned process instance. If a member is added to a parent process instance, the child process instance also inherits the members. The following new APIs have been added: Add Members to an Instance Delete a Member of an Instance Get Member Details of an Instance and IdentityId Get Members of an InstanceId Update/Delete Members of an Instance
User Tasks	In the List Task Comments API, the isTaskLevelComments query parameter has been deprecated. Instead, use the isTaskSpecificComments query parameter. In the List Task Documents API, the isTaskLevelComments query parameter has been deprecated. Instead, use the isTaskSpecificComments query parameter.

February 2023

REST API Category	Changes in REST API
Processes	A new property terminateChildInstances has been added in the Perform an Action on Process Instance function. When a dynamic process is terminated, this flag controls the termination of the child structured processes.

September 2022

REST API Category	Changes in REST API
Authentication	A new authentication section has been added that shows how to access Oracle Cloud Infrastructure Process Automation REST APIs.
Credentials	The following new REST APIs have been added: Create a New Credential Delete a Credential Key Get Credential Details Update a Credential Key and Map
Connectors	The following new REST APIs have been added: Get a Connector List all Connectors Update the Base URL for a Connector
Tasks	In the Upload a Task Document and Upload Process Document to Storage APIs, you can now upload an external URL link to storage. This link can contain documents that can be downloaded.

July 2022

REST API Category	Changes in REST API
User Tasks	New REST APIs to withdraw tasks and reassign tasks. The following new query parameters are added in the List Tasks API: expiryDateAfter expiryDateBefore New isTaskLevelComments query parameter in List Task Comments to fetch task level comments. New dueDate property in Update a Task to update the due date.
Structured Processes	New isRetryAllowed property in the 200 Response has been added in the following APIs: Get a Process Instance Job List Process Instance Jobs Resubmit a Process Instance Job

May 2022

REST API Category	Changes in REST API
List Tasks	The rootProcessId query parameter has been deprecated. Use the rootInstanceId instead. See List Tasks.

March 2022

REST API Category	Changes in REST API
List Tasks	The following parameters have been deprecated: processInstanceBusinessKey processInstanceBusinessKeyLike dpInstanceBusinessKey dpInstanceBusinessKeyLike Use the following parameters instead: businessKey businessKeyLike See List Tasks.