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

# Delete workflow transition rule configurations

`PUT /rest/api/3/workflow/rule/config/delete`

Deletes workflow transition rules from one or more workflows. These 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 app can be deleted.

**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 apps can use this operation.

## Request body

- WorkflowsWithTransitionRulesDetails — Details of workflows and their transition rules to delete.
  - `workflows` WorkflowTransitionRulesDetails[], required — The list of workflows with transition rules to delete.
    - `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.
    - `workflowRuleIds` string[], required — The list of connect workflow rule IDs.

## 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 app.

---

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