# Reorder project steps

Source: https://www.jawsdeploy.net/rest-api/project-steps-order | Section: Project Steps

Replace the order of a project's steps in one call.

`PUT /api/project/steps/order`

Sets the order of the project's steps. Pass every step ID in the desired order; any step missing from `orderedStepIds` keeps its previous relative position at the end.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `projectId` | body | string | yes | ID of the project. |
| `orderedStepIds` | body | array<string> | yes | Step IDs in the desired order. |

## Errors

| Status | Meaning |
|---|---|
| 400 | Invalid `projectId` or unknown step ID. |
| 401 | Missing or invalid Basic auth credentials, or the service account lacks the required role. |

Example request:

```
PUT /api/project/steps/order

{ "projectId": "prj_abc123", "orderedStepIds": ["ps_2", "ps_1"] }
```

Example response:

```
{}
```