---
title: "Move a workflow state to a new position (reorder), shifting the states in between."
method: PUT
path: "/v2/scheduler/library/states/{stateId}/position"
tags: ["Library Posts State Api Service"]
---

# Move a workflow state to a new position (reorder), shifting the states in between.

`PUT /v2/scheduler/library/states/{stateId}/position`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/scheduler/library/states/{stateId}/position`
- Auth: none declared

## Path parameters

- `stateId` integer, required

## Request body

- MoveLibraryPostStateRequest: Body to move a workflow state to a new position.
  - `position` integer, required: 0-based target position among the brand's states.

## Response `200`

Resulting order of the brand's states.

- JsonOkListResponseLibraryPostStateDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` LibraryPostStateDto[]
    - `id` integer: State id.
    - `name` string: Display name of the state.
    - `color` string: Color of the state.
    - `position` integer: Ordering position of the state within the brand's workflow (ascending).

## Other responses

- `400`: Position out of range.
- `403`: User not authorized on the brand.
- `404`: State not found for this brand.

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)