---
title: "Get workflow transition rule configurations"
method: POST
path: "/rest/atlassian-connect/1/migration/workflow/rule/search"
tags: ["App migration"]
---

# Get workflow transition rule configurations

`POST /rest/atlassian-connect/1/migration/workflow/rule/search`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/atlassian-connect/1/migration/workflow/rule/search`
- Auth: none declared. Required headers: `Atlassian-Transfer-Id`

Returns configurations for workflow transition rules migrated from server to cloud and owned by the calling Connect app.

## Headers

- `Atlassian-Transfer-Id` string, uuid, required

## Request body

- WorkflowRulesSearch: Details of the workflow and its transition rules.
  - `expand` string: Use expand to include additional information in the response. This parameter accepts `transition` which, for each rule, returns information about the transition the rule is assigned to.
  - `ruleIds` string[], required: The list of workflow rule IDs.
  - `workflowEntityId` string, uuid, required: The workflow ID.

## Response `200`

Returned if the request is successful.

- WorkflowRulesSearchDetails: Details of workflow transition rules.
  - `invalidRules` string[]: List of workflow rule IDs that do not belong to the workflow or can not be found.
  - `validRules` WorkflowTransitionRules[]: List of valid workflow transition rules.
    - `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.
  - `workflowEntityId` string, uuid: The workflow ID.

## Other responses

- `400`: Returned if the request is not valid.
- `403`: Returned if the authorisation credentials are incorrect or missing.

---

[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.dev/atlassian/apis/the-jira-cloud-platform-rest-api/revisions/5b336c497218?raw)