---
title: "Move Sprint Item Endpoint"
method: POST
path: "/projects/{project_id}/sprint-items/{item_id}/move"
---

# Move Sprint Item Endpoint

`POST /projects/{project_id}/sprint-items/{item_id}/move`

## Request

- Base URL: `https://usemeridian.us` (the document declares no server; this is the origin it was published from)
- URL: `https://usemeridian.us/projects/{project_id}/sprint-items/{item_id}/move`
- Auth: none declared

Move a sprint item to another version, keeping its status and title.

Body: ``{"next": true}`` (the server computes the version following the
item's own and returns it) or ``{"to_version": "v2.5"}``; optionally
``expected_version`` (the version the caller saw -- a mismatch is a 409,
which keeps a replayed ``next`` from moving the item twice). Unlike
``/push`` the item is NOT deferred: it stays pending and shows up under the
target version. Response: ``{item, from_version, to_version, via,
unchanged, moved_children, history_recorded}``.

## Path parameters

- `project_id` string, required
- `item_id` string, required

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usemeridian/apis/meridian.md) · [All operations](https://skmtc.dev/usemeridian/apis/meridian/llms.txt) · [OpenAPI document](https://skmtc.dev/usemeridian/apis/meridian/revisions/f37a894bd374?raw)