---
title: "Set Folder Item Location"
method: PUT
path: "/v2/folder-item-locations"
tags: ["Folder API"]
---

# Set Folder Item Location

`PUT /v2/folder-item-locations`

Set the folder location for a folder item, or move it to the root by leaving folder_id unset. The destination must be in the same team and compatible folder tree as the item.

## Request body

- SvflowPublicapiSetFolderItemLocationRequest
  - `item` SvflowPubapimodelsFolderItem, required
    - `itemType` 'FOLDER_ITEM_TYPE_UNSPECIFIED' | 'FOLDER_ITEM_TYPE_FOLDER' | 'FOLDER_ITEM_TYPE_WORKFLOW' | 'FOLDER_ITEM_TYPE_GUIDANCE' — Types of items that can appear in folder contents.
    - `itemId` string
  - `folderId` string, nullable — The destination folder. Unset moves the item to the root (no folder). Must be in the same team and compatible folder tree as the item.

## Response `200`

Success

- SvflowPublicapiSetFolderItemLocationResponse
  - `data` SvflowPubapimodelsFolderItemLocation
    - `item` SvflowPubapimodelsFolderItem
      - `itemType` 'FOLDER_ITEM_TYPE_UNSPECIFIED' | 'FOLDER_ITEM_TYPE_FOLDER' | 'FOLDER_ITEM_TYPE_WORKFLOW' | 'FOLDER_ITEM_TYPE_GUIDANCE' — Types of items that can appear in folder contents.
      - `itemId` string
    - `folderId` string, nullable — Unset when the item is at the root.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)