---
title: "Move specified items from one workspace to another."
method: POST
path: "/api/workspaces/items/move"
tags: ["Items"]
---

# Move specified items from one workspace to another.

`POST /api/workspaces/items/move`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/workspaces/items/move`
- Auth: HTTP bearer

Returns ids of newly created items in the target workspace, with order of the returned ids matching the order of requested source items. Returns Not Found if either of the specified source items does not exist.<br/>Requirements:<br/>- auth-client scopes: "workspace"<br/>- user permission: "write" or higher

## Query parameters

- `actAsAdmin` boolean
- `sourceWorkspaceId` string, uuid, required
- `targetWorkspaceId` string, uuid, required

## Request body

- string[]

## Response `200`

List of newly created item IDs.

- string[]

## Other responses

- `400`: If payload is invalid or one of the specified source items or the target workspace does not exist.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, or authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

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