Reorder automation steps

POST

/automations/{uuid}/steps/reorder

Last modified:2026-02-17 18:57:15

Provide an array of step UUIDs with their new step_number values to reorder.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Steps reordered

Body

🟠404Record Not Found

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://connect.dispatchable.com/automations/api/v1/automations//steps/reorder' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "steps": [
        {
            "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
            "step_number": 1
        }
    ]
}'

Response Example

200 - Example 1

{
    "message": "Automation steps rearranged successfully.",
    "success": true
}

Modified at 2026-02-17 18:57:15

Create a new step in an automation

Get a single automation step