FlxpointAPI Help CenterBeta

Update Workflow

posthttps://api.flxpoint.com/workflow/update

Use this when you want to create workflow data through the API.

🔑 X-API-TOKEN⏱ 2 req/sToken: Account · Source · Channel

This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.

Update a workflow

Request

Bodyapplication/json
idintegerrequired
Generated on your behalf when first creating a workflow.
draftboolean
This value WILL NOT be modified and is only used to indicate whether or not this request is to update the draft version of the workflow
default false
rulesarray[UpdateOrCreateWorkflowRule]
The rules of the workflow that are responsible for checking IF and HOW modifications should be applied to `GlobalObjects` and their `GlobalObjectFields`.
idinteger
Generated on your behalf when first creating a rule. Should not be provided unless the rule was previously saved & you are modifying a version of the rule that was directly fetched from the system. By providing a `null` value here you are indicating a rule should be created. By providing a non-null value here you are indicating this rule exists within the `UpdateOrCreateWorkflow` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflow` already a `400` error wil be thrown
namestringrequired
The name of the rule, will be updated to whatever is provided.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
enabledboolean
Whether the workflow rule is enabled and should run.
groupsarray[UpdateOrCreateWorkflowRuleGroup]required
idinteger
Generated on your behalf when first creating a rule group. Should not be provided unless the rule group was previously saved & you are modifying a version of the rule group that was directly fetched from the system. By providing a `null` value here you are indiciating a rule should be created. By providing a non-null value here you are indicating this rule group exists within the `UpdateOrCreateWorkflowRule` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflowRule` already a `400` error wil be thrown
conditionsarray[UpdateOrCreateWorkflowCondition]required
idinteger
Leave as `null` in order to create a new condition. If provided with an ID that does not belong to the existing rule a `400` error will be returned.
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` that provides the data this rule runs against.
workflowDataTypeComparatorIdintegerrequired
The ID of the `WorkflowDataTypeComparator` this rule uses as a basis to perform a condition with.
conditionstring
For most standard rules the primary data condition that is used in conjunction with the comparator will be stored here.
condition2string
condition3string
condition4string
fieldArrayMustMatchAllboolean
When the field this condition operates on for the particular event is provided as an array of data rather than a singleton setting this to `true` means that all fields in that list must be truthy in order for the condition to be truthy. Otherwise only 1 of the fields in the list must be truthy to have the condition pass.
default false
conditionArrayMustMatchAllboolean
When the data this condition operates on for the particular event is provided as an array of data rather than a singleton setting this to `true` means that all data in that list must be truthy in order for the condition to be truthy. Otherwise only 1 of the datums in the list must be truthy to have the condition pass.
default false
preModifierDataTypeComparatorIdinteger
metaDatastring
This is a JSON encoded string that is used to provide & store context relating to rules that do not fit within the bounds of standard rules.
childConditionsarray[UpdateOrCreateWorkflowCondition]
actionsarray[UpdateOrCreateWorkflowRuleAction]required
idinteger
Generated on your behalf when first creating a action. Should not be provided unless the action was previously saved & you are modifying a version of the action that was directly fetched from the system. By providing a `null` value here you are indicating this action should be created. By providing a non-null value here you are indiciting this action exists within the `UpdateOrCreateWorkflowRule` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflowRule` already a `400` error wil be thrown
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
metaDatastring
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[UpdateOrCreateWorkflowRuleAction]
idinteger
Generated on your behalf when first creating a action. Should not be provided unless the action was previously saved & you are modifying a version of the action that was directly fetched from the system. By providing a `null` value here you are indicating this action should be created. By providing a non-null value here you are indiciting this action exists within the `UpdateOrCreateWorkflowRule` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflowRule` already a `400` error wil be thrown
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
metaDatastring
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[UpdateOrCreateWorkflowRuleAction]
headerNamestring
headerNamestring
childRulesarray[UpdateOrCreateWorkflowRule]
idinteger
Generated on your behalf when first creating a rule. Should not be provided unless the rule was previously saved & you are modifying a version of the rule that was directly fetched from the system. By providing a `null` value here you are indicating a rule should be created. By providing a non-null value here you are indicating this rule exists within the `UpdateOrCreateWorkflow` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflow` already a `400` error wil be thrown
namestringrequired
The name of the rule, will be updated to whatever is provided.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
enabledboolean
Whether the workflow rule is enabled and should run.
groupsarray[UpdateOrCreateWorkflowRuleGroup]required
idinteger
Generated on your behalf when first creating a rule group. Should not be provided unless the rule group was previously saved & you are modifying a version of the rule group that was directly fetched from the system. By providing a `null` value here you are indiciating a rule should be created. By providing a non-null value here you are indicating this rule group exists within the `UpdateOrCreateWorkflowRule` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflowRule` already a `400` error wil be thrown
conditionsarray[UpdateOrCreateWorkflowCondition]required
actionsarray[UpdateOrCreateWorkflowRuleAction]required
idinteger
Generated on your behalf when first creating a action. Should not be provided unless the action was previously saved & you are modifying a version of the action that was directly fetched from the system. By providing a `null` value here you are indicating this action should be created. By providing a non-null value here you are indiciting this action exists within the `UpdateOrCreateWorkflowRule` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflowRule` already a `400` error wil be thrown
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
metaDatastring
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[UpdateOrCreateWorkflowRuleAction]
headerNamestring
childRulesarray[UpdateOrCreateWorkflowRule]
idinteger
Generated on your behalf when first creating a rule. Should not be provided unless the rule was previously saved & you are modifying a version of the rule that was directly fetched from the system. By providing a `null` value here you are indicating a rule should be created. By providing a non-null value here you are indicating this rule exists within the `UpdateOrCreateWorkflow` already and should be updated. If the provided ID does not exist in the `UpdateOrCreateWorkflow` already a `400` error wil be thrown
namestringrequired
The name of the rule, will be updated to whatever is provided.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
enabledboolean
Whether the workflow rule is enabled and should run.
groupsarray[UpdateOrCreateWorkflowRuleGroup]required
actionsarray[UpdateOrCreateWorkflowRuleAction]required
childRulesarray[UpdateOrCreateWorkflowRule]
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts

Example request

post/workflow/update
curl -X POST "https://api.flxpoint.com/workflow/update" \
  -H "Accept: application/json" \
  -H "X-API-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
         "id": 0,
         "draft": true,
         "rules": [
           {
             "id": 0,
             "name": "string",
             "workflowRuleTypeId": 0,
             "alwaysRun": true,
             "enabled": true,
             "groups": [
               {
                 "id": null,
                 "conditions": null
               }
             ],
             "actions": [
               {
                 "id": null,
                 "globalObjectFieldId": null,
                 "workflowDataTypeActionId": null,
                 "value": null,
                 "value2": null,
                 "value3": null,
                 "value4": null,
                 "metaData": null,
                 "usesOtherFieldScope": null,
                 "applyToMatchedOnly": null,
                 "childActions": null,
                 "headerName": null
               }
             ],
             "childRules": [
               {
                 "id": null,
                 "name": null,
                 "workflowRuleTypeId": null,
                 "alwaysRun": null,
                 "enabled": null,
                 "groups": null,
                 "actions": null,
                 "childRules": null,
                 "tierData": null
               }
             ],
             "tierData": "string"
           }
         ]
       }'
Example body · application/json
{
  "id": 0,
  "draft": true,
  "rules": [
    {
      "id": 0,
      "name": "string",
      "workflowRuleTypeId": 0,
      "alwaysRun": true,
      "enabled": true,
      "groups": [
        {
          "id": null,
          "conditions": null
        }
      ],
      "actions": [
        {
          "id": null,
          "globalObjectFieldId": null,
          "workflowDataTypeActionId": null,
          "value": null,
          "value2": null,
          "value3": null,
          "value4": null,
          "metaData": null,
          "usesOtherFieldScope": null,
          "applyToMatchedOnly": null,
          "childActions": null,
          "headerName": null
        }
      ],
      "childRules": [
        {
          "id": null,
          "name": null,
          "workflowRuleTypeId": null,
          "alwaysRun": null,
          "enabled": null,
          "groups": null,
          "actions": null,
          "childRules": null,
          "tierData": null
        }
      ],
      "tierData": "string"
    }
  ]
}

Responses

200OKapplication/json
idintegerrequired
Generated on your behalf when first creating a workflow. Should not be provided unless the workflow was previously saved & you are modifying a version of the workflow that was directly fetched from the system. `null` values are never allowed here. By providing a non-null value here you are indiciating this workflow exists and should be updated. If the provided ID does not exist a `404` error will be returned.
eventIdinteger
draftboolean
Is this the draft version of the workflow
default false
paramsarray[GetWorkflowRequestParam]
Used to find workflows by unique key/value pairs so that IDs do not need to be externally managed.
keystringrequired
valueintegerrequired
rulesarray[WorkflowRule]
The rules of the workflow that are responsible for checking IF and HOW modifications should be applied to `GlobalObjects` and their `GlobalObjectFields`.
idinteger
Generated on your behalf when first creating a rule.
namestringrequired
createdAtstring (date-time)
rankinteger
The order/rank in which rules are run. Very important as order matters since each rule has the potential to modify data.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
configuredboolean
Whether the rule is configured correctly. To be considered configured the rule must have at least 1 action and 1 condition (or be set to always run).
groupsarray[WorkflowRuleGroup]required
idinteger
Generated on your behalf when first creating a rule group.
rankinteger
The order/rank in which groups are run
conditionsarray[WorkflowRuleGroupCondition]required
idinteger
Generated on your behalf when first creating a condition.
rankinteger
The order/rank in which conditions are run
globalObjectFieldIdinteger
The ID of the `GlobalObjectField` that provides the data this rule runs against.
workflowDataTypeComparatorIdinteger
The ID of the `WorkflowDataTypeComparator` this rule uses as a basis to perform a condition with.
conditionstring
For most standard rules the primary data condition that is used in conjunction with the comparator will be stored here.
condition2string
condition3string
condition4string
fieldArrayMustMatchAllboolean
When the field this condition operates on for the particular event is provided as an array of data rather than a singleton setting this to `true` means that all fields in that list must be truthy in order for the condition to be truthy. Otherwise only 1 of the fields in the list must be truthy to have the condition pass.
default false
conditionArrayMustMatchAllboolean
When the data this condition operates on for the particular event is provided as an array of data rather than a singleton setting this to `true` means that all data in that list must be truthy in order for the condition to be truthy. Otherwise only 1 of the datums in the list must be truthy to have the condition pass.
default false
preModifierDataTypeComparatorIdinteger
metaDatastring
This is a JSON encoded string that is used to provide & store context relating to rules that do not fit within the bounds of standard rules.
childConditionsarray[WorkflowRuleGroupCondition]
workflowDataTypeComparatorWorkflowDataTypeComparator
preModifierDataTypeComparatorWorkflowDataTypeComparator
actionsarray[WorkflowRuleAction]required
idinteger
Generated on your behalf when first creating a action.
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
rankinteger
The order/rank in which actions are run. Very important as order matters since each action has the potential to modify data.
workflowDataTypeActionobject
idintegerrequired
namestringrequired
handlestringrequired
allowedaddadd_fieldall_po_line_items_custom_fields_to_textappend_as_sentenceapply_custom_actionattribute_addattribute_modifyattribute_removeattributes_to_htmlcapitalize_each_wordcustom_aggregate_field_addcustom_aggregate_field_modifycustom_aggregate_field_removecustom_field_addcustom_field_modifycustom_field_removedecode_htmldivide_bydivide_by_fieldleft_padlowercasemultiplymultiply_by_fieldoption_setpercent_changepo_custom_fields_to_textpostfixpostfix_with_fieldprefixprefix_with_fieldreplacereplace_case_sensitivereplace_character_at_indexreplace_character_occurrenceright_padsentence_casesetset_decimalset_to_emptyset_to_fieldsplit_by_valuesubstringsubtractsubtract_fieldtrimuppercasevariant_option_addvariant_option_modifyvariant_option_removeset_ones_place_value_tomapping_set
hideInputboolean
usesOtherFieldbooleanrequired
formulabooleanrequired
globalDataTypeIdinteger
formulaCanRunAgainstGlobalObjectIdsarray[integer]
If `formula=true` then this will be a list of `GlobalObject.id` that the formula can be applied against.
globalDataTypeFilterIdsarray[integer]
Certain `GlobalObjectField`'s such as ones for quantities may wish to further restrict what types of actions they are allowed to run against. Actions that support this type of additional filtering will have the IDs of the filter types set here. The IDs in this array will correspond to the `GlobalObjectField.globalDataTypeFilterId` field.
metaDatastring
If non-null a JSON object containing meta data related to executing the action
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[WorkflowRuleAction]
idinteger
Generated on your behalf when first creating a action.
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
rankinteger
The order/rank in which actions are run. Very important as order matters since each action has the potential to modify data.
workflowDataTypeActionWorkflowDataTypeAction
metaDatastring
If non-null a JSON object containing meta data related to executing the action
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[WorkflowRuleAction]
headerNamestring
headerNamestring
childRulesarray[WorkflowRule]
idinteger
Generated on your behalf when first creating a rule.
namestringrequired
createdAtstring (date-time)
rankinteger
The order/rank in which rules are run. Very important as order matters since each rule has the potential to modify data.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
configuredboolean
Whether the rule is configured correctly. To be considered configured the rule must have at least 1 action and 1 condition (or be set to always run).
groupsarray[WorkflowRuleGroup]required
idinteger
Generated on your behalf when first creating a rule group.
rankinteger
The order/rank in which groups are run
conditionsarray[WorkflowRuleGroupCondition]required
actionsarray[WorkflowRuleAction]required
idinteger
Generated on your behalf when first creating a action.
globalObjectFieldIdintegerrequired
The ID of the `GlobalObjectField` this action will apply a transformation to.
workflowDataTypeActionIdintegerrequired
The ID of the `WorkflowDataTypeAction` that this action applys as a transformation/modification to a field.
valuestring
If the action type uses data indicated by the user to apply its transformations those values will be supplier here.
value2string
value3string
value4string
rankinteger
The order/rank in which actions are run. Very important as order matters since each action has the potential to modify data.
workflowDataTypeActionWorkflowDataTypeAction
metaDatastring
If non-null a JSON object containing meta data related to executing the action
usesOtherFieldScopestring
When using actions that depend on the values of other fields & objects this will control which objects are used to take values from.
allowedallfilteredcorrelated
applyToMatchedOnlyboolean
When true, the action is applied only to elements that satisfy the rule conditions. When false or not provided, the action is applied to all elements.
childActionsarray[WorkflowRuleAction]
headerNamestring
childRulesarray[WorkflowRule]
idinteger
Generated on your behalf when first creating a rule.
namestringrequired
createdAtstring (date-time)
rankinteger
The order/rank in which rules are run. Very important as order matters since each rule has the potential to modify data.
workflowRuleTypeIdintegerrequired
The ID of the `WorkflowRuleType` of this rule.
alwaysRunbooleanrequired
When set to `true` all `groups` & `conditions` are ignored and the rule will always have its a`actions` run.
default false
configuredboolean
Whether the rule is configured correctly. To be considered configured the rule must have at least 1 action and 1 condition (or be set to always run).
groupsarray[WorkflowRuleGroup]required
actionsarray[WorkflowRuleAction]required
childRulesarray[WorkflowRule]
workflowRuleTypeWorkflowRuleType
enabledboolean
identifies whether the workflow rule is enabled
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts
workflowRuleTypeobject
idintegerrequired
handlestringrequired
allowedconditionaltier
namestringrequired
enabledboolean
identifies whether the workflow rule is enabled
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts
workflowRuleTypeobject
idintegerrequired
handlestringrequired
allowedconditionaltier
namestringrequired
enabledboolean
identifies whether the workflow rule is enabled
tierDatastring
Stores data needed to run new style tier rules set from enterprise accounts
fieldsUsedBySetToFieldarray[any]
fieldsUsedByFormulasarray[any]
Example response
{
  "id": 0,
  "eventId": 0,
  "draft": true,
  "params": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "rules": [
    {
      "id": 0,
      "name": "string",
      "createdAt": "2026-04-20T00:00:00Z",
      "rank": 0,
      "workflowRuleTypeId": 0,
      "alwaysRun": true,
      "configured": true,
      "groups": [
        {
          "id": null,
          "rank": null,
          "conditions": null
        }
      ],
      "actions": [
        {
          "id": null,
          "globalObjectFieldId": null,
          "workflowDataTypeActionId": null,
          "value": null,
          "value2": null,
          "value3": null,
          "value4": null,
          "rank": null,
          "workflowDataTypeAction": null,
          "metaData": null,
          "usesOtherFieldScope": null,
          "applyToMatchedOnly": null,
          "childActions": null,
          "headerName": null
        }
      ],
      "childRules": [
        {
          "id": null,
          "name": null,
          "createdAt": null,
          "rank": null,
          "workflowRuleTypeId": null,
          "alwaysRun": null,
          "configured": null,
          "groups": null,
          "actions": null,
          "childRules": null,
          "workflowRuleType": null,
          "enabled": null,
          "tierData": null
        }
      ],
      "workflowRuleType": {
        "id": 0,
        "handle": "conditional",
        "name": "string"
      },
      "enabled": true,
      "tierData": "string"
    }
  ],
  "fieldsUsedBySetToField": [
    null
  ],
  "fieldsUsedByFormulas": [
    null
  ]
}
401Unauthorized

No schema documented for this status.

OpenAPI fragment
{
  "post": {
    "summary": "Update Workflow",
    "description": "Update a workflow",
    "parameters": [],
    "requestBody": {
      "description": "",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/UpdateWorkflow"
          }
        }
      }
    },
    "responses": {
      "200": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Workflow"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized"
      }
    }
  }
}
Ready to run it? Send the curl from your terminal or Postman, or use the interactive tester in Stoplight.Open in Stoplight