Bulk update workflows

POST

/rest/api/3/workflows/update

Update workflows and related statuses.

Permissions required:

Administer Jira project permission to create all, including global-scoped, workflows

Administer projects project permissions to create project-scoped workflows

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/rest/api/3/workflows/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "statuses": [
        {
            "description": "",
            "name": "To Do",
            "statusCategory": "TODO",
            "statusReference": "f0b24de5-25e7-4fab-ab94-63d81db6c0c0"
        },
        {
            "description": "",
            "name": "In Progress",
            "statusCategory": "IN_PROGRESS",
            "statusReference": "c7a35bf0-c127-4aa6-869f-4033730c61d8"
        },
        {
            "description": "",
            "name": "Done",
            "statusCategory": "DONE",
            "statusReference": "6b3fc04d-3316-46c5-a257-65751aeb8849"
        }
    ],
    "workflows": [
        {
            "defaultStatusMappings": [
                {
                    "newStatusReference": "10011",
                    "oldStatusReference": "10010"
                }
            ],
            "description": "",
            "id": "10001",
            "startPointLayout": {
                "x": -100.00030899047852,
                "y": -153.00020599365234
            },
            "statusMappings": [
                {
                    "issueTypeId": "10002",
                    "projectId": "10003",
                    "statusMigrations": [
                        {
                            "newStatusReference": "10011",
                            "oldStatusReference": "10010"
                        }
                    ]
                }
            ],
            "statuses": [
                {
                    "layout": {
                        "x": 114.99993896484375,
                        "y": -16
                    },
                    "properties": {},
                    "statusReference": "f0b24de5-25e7-4fab-ab94-63d81db6c0c0"
                },
                {
                    "layout": {
                        "x": 317.0000915527344,
                        "y": -16
                    },
                    "properties": {},
                    "statusReference": "c7a35bf0-c127-4aa6-869f-4033730c61d8"
                },
                {
                    "layout": {
                        "x": 508.000244140625,
                        "y": -16
                    },
                    "properties": {},
                    "statusReference": "6b3fc04d-3316-46c5-a257-65751aeb8849"
                }
            ],
            "transitions": [
                {
                    "actions": [],
                    "description": "",
                    "id": "1",
                    "links": [],
                    "name": "Create",
                    "properties": {},
                    "toStatusReference": "f0b24de5-25e7-4fab-ab94-63d81db6c0c0",
                    "triggers": [],
                    "type": "INITIAL",
                    "validators": []
                },
                {
                    "actions": [],
                    "description": "",
                    "id": "11",
                    "links": [],
                    "name": "To Do",
                    "properties": {},
                    "toStatusReference": "f0b24de5-25e7-4fab-ab94-63d81db6c0c0",
                    "triggers": [],
                    "type": "GLOBAL",
                    "validators": []
                },
                {
                    "actions": [],
                    "description": "",
                    "id": "21",
                    "links": [],
                    "name": "In Progress",
                    "properties": {},
                    "toStatusReference": "c7a35bf0-c127-4aa6-869f-4033730c61d8",
                    "triggers": [],
                    "type": "GLOBAL",
                    "validators": []
                },
                {
                    "actions": [],
                    "description": "Move a work item from in progress to done",
                    "id": "31",
                    "links": [
                        {
                            "fromPort": 0,
                            "fromStatusReference": "c7a35bf0-c127-4aa6-869f-4033730c61d8",
                            "toPort": 1
                        }
                    ],
                    "name": "Done",
                    "properties": {},
                    "toStatusReference": "6b3fc04d-3316-46c5-a257-65751aeb8849",
                    "triggers": [],
                    "type": "DIRECTED",
                    "validators": []
                }
            ],
            "version": {
                "id": "6f6c988b-2590-4358-90c2-5f7960265592",
                "versionNumber": 1
            }
        }
    ]
}'

Response Example

{"statuses":[{"description":"","id":"10001","name":"To Do","scope":{"type":"GLOBAL"},"statusCategory":"TODO","statusReference":"10001","usages":[]},{"description":"","id":"10002","name":"In Progress","scope":{"type":"GLOBAL"},"statusCategory":"IN_PROGRESS","statusReference":"10002","usages":[]},{"description":"","id":"10003","name":"Done","scope":{"type":"GLOBAL"},"statusCategory":"DONE","statusReference":"10003","usages":[]}],"taskId":"10001","workflows":[{"description":"","id":"b9ff2384-d3b6-4d4e-9509-3ee19f607168","isEditable":true,"name":"Software workflow 1","scope":{"type":"GLOBAL"},"startPointLayout":{"x":-100.00030899047852,"y":-153.00020599365234},"statuses":[{"deprecated":false,"layout":{"x":317.0000915527344,"y":-16.0},"properties":{},"statusReference":"10002"},{"deprecated":false,"layout":{"x":508.000244140625,"y":-16.0},"properties":{},"statusReference":"10003"},{"deprecated":false,"layout":{"x":114.99993896484375,"y":-16.0},"properties":{},"statusReference":"10001"}],"transitions":[{"actions":[],"description":"","id":"21","links":[],"name":"In Progress","properties":{},"toStatusReference":"10002","triggers":[],"type":"GLOBAL","validators":[]},{"actions":[],"description":"","id":"31","links":[{"fromPort":0,"fromStatusReference":"10002","toPort":1}],"name":"Done","properties":{},"toStatusReference":"10003","triggers":[],"type":"DIRECTED","validators":[]},{"actions":[],"description":"","id":"1","links":[],"name":"Create","properties":{},"toStatusReference":"10001","triggers":[],"type":"INITIAL","validators":[]},{"actions":[],"description":"","id":"11","links":[],"name":"To Do","properties":{},"toStatusReference":"10002","triggers":[],"type":"GLOBAL","validators":[]}],"usages":[],"version":{"id":"f010ac1b-3dd3-43a3-aa66-0ee8a447f76e","versionNumber":0}}]}

Request

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Returned if the request is successful.

Body

🟠400Bad Request

🟠401Unauthorized

🟠409409

Modified at 2025-07-16 07:18:01

Search workflows

Validate update workflows