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

# Get workflow transition rule configurations

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

Returns a [paginated](#pagination) list of workflows with transition rules. The workflows can be filtered to return only those containing workflow transition rules:

 *  of one or more transition rule types, such as [workflow post functions](https://developer.atlassian.com/cloud/jira/platform/modules/workflow-post-function/).
 *  matching one or more transition rule keys.

Only workflows containing transition 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 are returned.

Due to server-side optimizations, workflows with an empty list of rules may be returned; these workflows can be ignored.

**[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.

## Query parameters

- `startAt` integer
- `maxResults` integer
- `types` string[], required
- `keys` string[]
- `workflowNames` string[]
- `withTags` string[]
- `draft` boolean
- `expand` string

## Response `200`

Returned if the request is successful.

- PageBeanWorkflowTransitionRules — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` WorkflowTransitionRules[] — The list of items.
    - `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.

## Other responses

- `400` — Returned if the request is invalid.
- `403` — Returned if the caller is not a Connect or Forge app.
- `404` — Returned if any transition rule type is not supported.
- `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/7e9af75061ea/schema)