Start a Process Instance

Learn how The task helps you to start a process instance.

Use this API to start a workflow process instance. By default, Reltio allows you to start up to 15,000 processes a day in a given tenant. The API returns a 429 HTTP response status code if you exceed this number of processes.

If you want to reduce this daily request threshold, for example, to manage your load predictions and optimize resource utilization, contact Reltio Support.

Request

Operation Endpoint:

 POST {workflowPath}/workflow/{tenantId}/processInstances

Table 1. Parameters
Parameter		Required	Description
Headers	`Authorization`	Yes	Access Token in format `"Bearer <accessToken>"` (see details in Authentication API).
	`Content-Type`	Yes	Should be `"Content-Type: application/json"`.
	`EnvironmentURL`	Yes	Reltio Environment URL.
`Body`	`processType`	Yes	Process definition type.
	`objectURIs`	Yes	List of Reltio object URIs (entity/relation).
	`comment`	No	Process instance comment.
	`variables`	No	Additional process variables, such as specific task variables or assignee, that need to be passed during the workflow creation.

Sample Request:

{
    "processType": "reviewUpdateAttribute",
    "objectURIs": ["entities/e1"],
    "comment": "Started Review update attribute process",
    "variables": {
        "key1": "value1",
        "key2": "value2"  
    }
}

Response Structure:

processInstanceId- ID of the process instance created
error- returned if an error is encountered, contains details of the issue:
- errorCode- 5-digit error code
- errorMessage- error message
- errorData- details of the error:
  - exception- exception message
  - stack- stack trace
- innerError- details of the error from Reltio API:
  - errorMessage- Reltio API error message
  - errorCode- Reltio API error code
  - innerErrorData- Reltio API inner error data
warning- returned if the operation is completed with some minor issues
status- result of the operation; possible values are "OK" or "failed"

Example

Sample Response JSON:

{ "processInstanceId":"1234", "status":"OK"}

Note: This method (or for that matter, any action creating a task) does not validate a task being created. An invalid task is identified and cleaned up when retrieving it, updating it or executing an action on it.

You've found your way to a temporary environment. Content is not complete or final. Looking for Reltio documentation? Go to docs.reltio.com.

© 2024 The RELTIO® mark is a registered trademark of Reltio, Inc. in the United States and other countries; DataDriven and Reltio Data Cloud are trademarks of Reltio, Inc. Other names or marks are trademarks of their respective owners.

Terms, Privacy Policy, and

Unify and manage your data

Start a Process Instance

Footer