---
title: "Move a sync item"
method: POST
path: "/sync/items/{itemId}/move"
tags: ["sync"]
---

# Move a sync item

`POST /sync/items/{itemId}/move`

Atomically renames a sync item across local filesystem, remote repository, and sync state

## Path parameters

- `itemId` string, required

## Query parameters

- `remoteNode` string

## Request body

- object
  - `newItemId` string, required — The new sync item identifier
  - `message` string — Commit message for the move
  - `force` boolean — Force move even if the sync item has conflicts

## Response `200`

Sync item moved successfully

- SuccessResponse — Generic success response
  - `message` string, required — Success message

## Other responses

- `400` — Sync item cannot be moved
- `404` — Sync item not found
- `409` — Conflict detected
- `default` — Unexpected error

---

[API](https://skmtc.net/dagucloud/apis/dagu.md) · [All operations](https://skmtc.net/dagucloud/apis/dagu/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dagucloud/dagu/revisions/93cc41f2018a/schema)