Update an existing flow definition - Precisely Data Integrity Suite

Data Integrity Suite APIs
Product
Data_Integrity
Spatial_Analytics
Data_Enrichment
geo_addressing_1
Services
Spatial Analytics
Data Enrichment
Geo Addressing
ft:title
Data Integrity Suite APIs
ft:locale
en-US
PublicationType
pt_developer
copyrightfirst
2023
copyrightlast
2026

Updates an existing Multipass flow definition. The flow definition must be valid JSON containing the updated flow configuration.

PUT https://hostname/v1/multipass/flows/{flowId}

Request

Path parameters

Key Required Type Description
flowId Yes string

Unique identifier for the Multipass flow

Header keys

Table 1.
Key Required Type Description
X-Request-Id No String

An optional header that allows clients to supply a unique identifier for the request. When provided, this value is recorded by the system and can be used to trace and diagnose issues more efficiently. Supplying an X‑Request‑Id enables precise request tracking without manual log searches. The maximum supported length is 38 characters.

Request body example

{
  "startOperatorId": "transform_data",
  "inputDataKey": "input",
  "operators": [
    {
      "id": "transform_data",
      "type": "Transform",
      "key": "result",
      "operation": "input.value",
      "nextNode": "return_result"
    },
    {
      "id": "return_result",
      "type": "Return",
      "resultExpression": "result"
    }
  ]
}

Response

The response returns the operation status (SUCCESS or FAILURE) and the identifier of the flow.

Response body properties

Property Type Description
status string

Represents the outcome of the operation. Common values include SUCCESS or FAILURE, depending on whether the request was processed successfully.
flowId string The unique identifier of the Multipass flow associated with the request or response. This value corresponds to the flow being updated.

Response examples

Example status code responses for this method are shown here.

Examples
{
  "result": {
    "operation": "UPDATE",
    "status": "SUCCESS",
    "flowId": "updated_flow_id"
  }
}
 
{
  "id": "6900b63d72d75452c6c982afef49dc70",
  "errors": [
    {
      "code": "DIS-MP-1003",
      "detail": "Flow Not Found for the given flow Id."
    }
  ]
}
 
{
  "id": "b17e82b13b6b7d88eaf886636fae8b4d",
  "errors": [
    {
      "code": "DIS-1002",
      "detail": "You do not have permission to access this API"
    }
  ]
}
 
{
  "id": "f287c3b95d11f9ff28472ccc9ff38929",
  "errors": [
    {
      "code": "DIS-1005",
      "detail": "Rate limit exceeded"
    }
  ]
}
 
{
  "id": "6900b63d72d75452c6c982afef49dc70",
  "errors": [
    {
      "code": "DIS-MP-1003",
      "detail": "Flow Not Found for the given flow Id."
    }
  ]
}
 
{
  "id": "f287c3b95d11f9ff28472ccc9ff38929",
  "errors": [
    {
      "code": "DIS-1003",
      "detail": "Issue with internal services. Please try again after sometime"
    }
  ]
}