Pricing Templates
Log in Sign up
Integrations / Jira / ...

POST /rest/api/2/workflows/create/validation

Validate the payload for bulk create workflows.

Permissions required:

Servers

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
payload Object Yes

The create workflows payload.
payload.workflows[] Array No

The details of the workflows to create.
payload.workflows[].transitions[] Array Yes

The transitions of this workflow.
payload.workflows[].transitions[].customIssueEventId String No

The custom event ID of the transition.
payload.workflows[].transitions[].description String No

The description of the transition.
payload.workflows[].transitions[].transitionScreen Object No

The configuration of the rule.
payload.workflows[].transitions[].transitionScreen.id String No

The ID of the rule.
payload.workflows[].transitions[].transitionScreen.ruleKey String Yes

The rule key of the rule.
payload.workflows[].transitions[].transitionScreen.parameters Object No

The parameters related to the rule.
payload.workflows[].transitions[].properties Object No

The properties of the transition.
payload.workflows[].transitions[].triggers[] Array No

The triggers of the transition.
payload.workflows[].transitions[].triggers[].id String No

The ID of the trigger.
payload.workflows[].transitions[].triggers[].ruleKey String Yes

The rule key of the trigger.
payload.workflows[].transitions[].triggers[].parameters Object Yes

The parameters of the trigger.
payload.workflows[].transitions[].conditions Object No

The conditions group associated with the transition.
payload.workflows[].transitions[].conditions.operation String Yes

Determines how the conditions in the group are evaluated. Accepts either ANY or ALL. If ANY is used, at least one condition in the group must be true for the group to evaluate to true. If ALL is used, all conditions in the group must be true for the group to evaluate to true.

Possible values:

  • "ANY"
  • "ALL"
payload.workflows[].transitions[].conditions.conditions[] Array No

The rules for this condition.
payload.workflows[].transitions[].conditions.conditions[].id String No

The ID of the rule.
payload.workflows[].transitions[].conditions.conditions[].ruleKey String Yes

The rule key of the rule.
payload.workflows[].transitions[].conditions.conditions[].parameters Object No

The parameters related to the rule.
payload.workflows[].transitions[].conditions.conditionGroups[] Array No

The nested conditions of the condition group.
payload.workflows[].transitions[].links[] Array No

The statuses the transition can start from, and the mapping of ports between the statuses.
payload.workflows[].transitions[].links[].fromStatusReference String No

The status that the transition starts from.
payload.workflows[].transitions[].links[].toPort Integer No

The port that the transition goes to.
payload.workflows[].transitions[].links[].fromPort Integer No

The port that the transition starts from.
payload.workflows[].transitions[].id String No

The ID of the transition.
payload.workflows[].transitions[].validators[] Array No

The validators of the transition.
payload.workflows[].transitions[].validators[].id String No

The ID of the rule.
payload.workflows[].transitions[].validators[].ruleKey String Yes

The rule key of the rule.
payload.workflows[].transitions[].validators[].parameters Object No

The parameters related to the rule.
payload.workflows[].transitions[].actions[] Array No

The post-functions of the transition.
payload.workflows[].transitions[].actions[].id String No

The ID of the rule.
payload.workflows[].transitions[].actions[].ruleKey String Yes

The rule key of the rule.
payload.workflows[].transitions[].actions[].parameters Object No

The parameters related to the rule.
payload.workflows[].transitions[].name String No

The name of the transition.
payload.workflows[].transitions[].type String No

The transition type.

Possible values:

  • "DIRECTED"
  • "INITIAL"
  • "GLOBAL"
payload.workflows[].transitions[].toStatusReference String No

The status the transition goes to.
payload.workflows[].loopedTransitionContainerLayout Object No

The starting point for the statuses in the workflow.
payload.workflows[].loopedTransitionContainerLayout.x Number No

The x axis location.
payload.workflows[].loopedTransitionContainerLayout.y Number No

The y axis location.
payload.workflows[].name String Yes

The name of the workflow to create.
payload.workflows[].description String No

The description of the workflow to create.
payload.workflows[].startPointLayout Object No

The starting point for the statuses in the workflow.
payload.workflows[].startPointLayout.x Number No

The x axis location.
payload.workflows[].startPointLayout.y Number No

The y axis location.
payload.workflows[].statuses[] Array Yes

The statuses associated with this workflow.
payload.workflows[].statuses[].layout Object No

The starting point for the statuses in the workflow.
payload.workflows[].statuses[].layout.x Number No

The x axis location.
payload.workflows[].statuses[].layout.y Number No

The y axis location.
payload.workflows[].statuses[].properties Object Yes

The properties for this status layout.
payload.workflows[].statuses[].approvalConfiguration Object No

The approval configuration of a status within a workflow. Applies only to Jira Service Management approvals.
payload.workflows[].statuses[].approvalConfiguration.fieldId String Yes

The custom field ID of the "Approvers" or "Approver Groups" field.
payload.workflows[].statuses[].approvalConfiguration.prePopulatedFieldId String No

The custom field ID of the field used to pre-populate the Approver field. Only supports the "Affected Services" field.
payload.workflows[].statuses[].approvalConfiguration.active String Yes

Whether the approval configuration is active.

Possible values:

  • "false"
  • "true"
payload.workflows[].statuses[].approvalConfiguration.conditionValue String Yes

The number or percentage of approvals required for a request to be approved. If conditionType is number, the value must be 20 or less. If conditionType is percent, the value must be 100 or less.
payload.workflows[].statuses[].approvalConfiguration.transitionRejected String Yes

The numeric ID of the transition to be executed if the request is declined.
payload.workflows[].statuses[].approvalConfiguration.conditionType String Yes

How the required approval count is calculated. It may be configured to require a specific number of approvals, or approval by a percentage of approvers. If the approvers source field is Approver groups, you can configure how many approvals per group are required for the request to be approved. The number will be the same across all groups.

Possible values:

  • "percent"
  • "numberPerPrincipal"
  • "number"
payload.workflows[].statuses[].approvalConfiguration.transitionApproved String Yes

The numeric ID of the transition to be executed if the request is approved.
payload.workflows[].statuses[].approvalConfiguration.exclude[] Array No

A list of roles that should be excluded as possible approvers.

Possible values:

  • "reporter"
  • "assignee"
payload.workflows[].statuses[].statusReference String Yes

A unique ID which the status will use to refer to this layout configuration.
payload.scope Object No

The scope of the workflow.
payload.scope.type String No

The scope of the workflow. GLOBAL for company-managed projects and PROJECT for team-managed projects.

Possible values:

  • "GLOBAL"
  • "PROJECT"
payload.scope.project Object No

Project ID details.
payload.scope.project.id String Yes

The ID of the project.
payload.statuses[] Array No

The statuses to associate with the workflows.
payload.statuses[].id String No

The ID of the status.
payload.statuses[].name String Yes

The name of the status.
payload.statuses[].description String No

The description of the status.
payload.statuses[].statusCategory String Yes

The category of the status.

Possible values:

  • "TODO"
  • "DONE"
  • "IN_PROGRESS"
payload.statuses[].statusReference String Yes

The reference of the status.
validationOptions Object No

The level of validation to return from the API. If no values are provided, the default would return WARNING and ERROR level validation results.
validationOptions.levels[] Array No

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.
All third party trademarks (including logos and icons) are the property of their respective owners, which do not sponsor, authorize, or endorse this website.
Pricing Templates Integrations Blog Contact Us Help
© 2025 SimWorkflow
Terms of Service Privacy Policy