---
title: "Update workflow transition rule configurations"
method: PUT
path: "/rest/api/2/workflow/rule/config"
tags: ["Workflow transition rules"]
---

# Update workflow transition rule configurations

`PUT /rest/api/2/workflow/rule/config`

Updates configuration of workflow transition rules. The following rule types are supported:

 *  [post functions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-post-function/)
 *  [conditions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-condition/)
 *  [validators](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-validator/)

Only rules created by the calling [Connect](https://developer.atlassian.com/cloud/jira/platform/index/#connect-apps) or [Forge](https://developer.atlassian.com/cloud/jira/platform/index/#forge-apps) app can be updated.

To assist with app migration, this operation can be used to:

 *  Disable a rule.
 *  Add a `tag`. Use this to filter rules in the [Get workflow transition rule configurations](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-transition-rules/#api-rest-api-3-workflow-rule-config-get).

Rules are enabled if the `disabled` parameter is not provided.

**Note:** The `draft` parameter in the request body WorkflowId is deprecated and will be removed from this API on [November 2, 2026](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-3147).

**[Permissions](#permissions) required:** Only [Connect](https://developer.atlassian.com/cloud/jira/platform/index/#connect-apps) or [Forge](https://developer.atlassian.com/cloud/jira/platform/index/#forge-apps) apps can use this operation.

## Request body

- WorkflowTransitionRulesUpdate — Details about a workflow configuration update request.
  - `workflows` WorkflowTransitionRules[], required — The list of workflows with transition rules to update.
    - `conditions` AppWorkflowTransitionRule[] — The list of conditions within the workflow.
      - `configuration` RuleConfiguration, required — A rule configuration.
        - `disabled` boolean — Whether the rule is disabled.
        - `tag` string — A tag used to filter rules in [Get workflow transition rule configurations](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-transition-rules/#api-rest-api-3-workflow-rule-config-get).
        - `value` string, required — Configuration of the rule, as it is stored by the Connect or the Forge app on the rule configuration page.
      - `id` string, required — The ID of the transition rule.
      - `key` string, required — The key of the rule, as defined in the Connect or the Forge app descriptor.
      - `transition` WorkflowTransition — A workflow transition.
        - `id` integer, required — The transition ID.
        - `name` string, required — The transition name.
    - `postFunctions` AppWorkflowTransitionRule[] — The list of post functions within the workflow.
      - `configuration` RuleConfiguration, required — A rule configuration.
        - `disabled` boolean — Whether the rule is disabled.
        - `tag` string — A tag used to filter rules in [Get workflow transition rule configurations](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-transition-rules/#api-rest-api-3-workflow-rule-config-get).
        - `value` string, required — Configuration of the rule, as it is stored by the Connect or the Forge app on the rule configuration page.
      - `id` string, required — The ID of the transition rule.
      - `key` string, required — The key of the rule, as defined in the Connect or the Forge app descriptor.
      - `transition` WorkflowTransition — A workflow transition.
        - `id` integer, required — The transition ID.
        - `name` string, required — The transition name.
    - `validators` AppWorkflowTransitionRule[] — The list of validators within the workflow.
      - `configuration` RuleConfiguration, required — A rule configuration.
        - `disabled` boolean — Whether the rule is disabled.
        - `tag` string — A tag used to filter rules in [Get workflow transition rule configurations](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-workflow-transition-rules/#api-rest-api-3-workflow-rule-config-get).
        - `value` string, required — Configuration of the rule, as it is stored by the Connect or the Forge app on the rule configuration page.
      - `id` string, required — The ID of the transition rule.
      - `key` string, required — The key of the rule, as defined in the Connect or the Forge app descriptor.
      - `transition` WorkflowTransition — A workflow transition.
        - `id` integer, required — The transition ID.
        - `name` string, required — The transition name.
    - `workflowId` WorkflowId, required — Properties that identify a workflow.
      - `draft` boolean — **Deprecated:** Whether the workflow is in the draft state. The 'draft' parameter will be removed from this API on [November 2, 2026](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-3147).
      - `name` string, required — The name of the workflow.

## Response `200`

Returned if the request is successful.

- WorkflowTransitionRulesUpdateErrors — Details of any errors encountered while updating workflow transition rules.
  - `updateResults` WorkflowTransitionRulesUpdateErrorDetails[], required — A list of workflows.
    - `ruleUpdateErrors` object, required — A list of transition rule update errors, indexed by the transition rule ID. Any transition rule that appears here wasn't updated.
    - `updateErrors` string[], required — The list of errors that specify why the workflow update failed. The workflow was not updated if the list contains any entries.
    - `workflowId` WorkflowId, required — Properties that identify a workflow.
      - `draft` boolean — **Deprecated:** Whether the workflow is in the draft state. The 'draft' parameter will be removed from this API on [November 2, 2026](https://developer.atlassian.com/cloud/jira/platform/changelog/#CHANGE-3147).
      - `name` string, required — The name of the workflow.

## Other responses

- `400` — Returned if the request is invalid.
- `403` — Returned if the caller is not a Connect or Forge app.
- `503` — Returned if we encounter a problem while trying to access the required data.

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/40fd882d2209/schema)