---
title: "Adds one or more items to a folder."
method: POST
path: "/v1/folders/{folderId}/items"
tags: ["Assets"]
---

# Adds one or more items to a folder.

`POST /v1/folders/{folderId}/items`

## Request

- Base URL: `https://itemconfiguration.roblox.com`
- URL: `https://itemconfiguration.roblox.com/v1/folders/{folderId}/items`
- Auth: one of:
  - API key in cookie `.ROBLOSECURITY`
  - API key in header `x-api-key`

## Path parameters

- `folderId` string, required

## Request body

- RobloxItemConfigurationApiModelsRequestFolderAddItemsRequest: Request model for adding one or more items to a folder.
  - `items` RobloxItemConfigurationApiModelsFolderFolderItem[]: The items to add to the folder.
    - `id` string: The unique identifier for the item.
    - `itemType` 'Unknown' | 'Asset' | 'Bundle' | 'IECToken' | 'Folder': The type of the item to be added to the folder. ['Unknown' = 0, 'Asset' = 1, 'Bundle' = 2, 'IECToken' = 3, 'Folder' = 4]

## Response `200`

OK

- RobloxWebWebAPIApiEmptyResponseModel

## Other responses

- `400`: 1: The folder ID is invalid. 3: The item ID is invalid. 4: The item type is invalid. 12: Missing/Null request parameters 18: Too many items were passed in a single request. 19: The folder item limit has been reached.
- `401`: 0: Authorization has been denied for this request. 7: The authenticated user is missing.
- `403`: 0: Token Validation Failed 8: The user does not own the folder. 9: The user does not own the item.
- `404`: 5: The folder was not found. 6: The item was not found.
- `503`: 11: The service is unavailable.

## Changes

- **2026-11-13** `e1e00fbc18e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/folders/:folderId/items/post.md)

---

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