> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genviral.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Folder Items

> Add files or slideshows to a folder

Adds one or more in-scope file or slideshow IDs to a folder. Duplicate IDs in the request are deduped server-side.

## Path Parameters

<ParamField path="folderId" type="string" required>
  Folder UUID.
</ParamField>

## Body Parameters

<ParamField body="item_ids" type="string[]" required>
  UUIDs of files or slideshows to add (`1-200` items).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://www.genviral.io/api/partner/v1/folders/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa/items \
    --header 'Authorization: Bearer <token>' \
    --header 'Content-Type: application/json' \
    --data '{
      "item_ids": [
        "11111111-1111-1111-1111-111111111111",
        "22222222-2222-2222-2222-222222222222"
      ]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "ok": true,
    "code": 200,
    "message": "Folder items added",
    "data": {
      "folder_id": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "item_type": "file",
      "added_count": 2
    }
  }
  ```
</ResponseExample>

## Error Responses

* `400 invalid_json` - malformed JSON body
* `422 invalid_path` - `folderId` is not a valid UUID
* `422 invalid_payload` - missing or invalid `item_ids`
* `404 not_found` - folder not visible in key scope
* `404 item_not_found` - one or more item IDs are not visible in key scope
* `401` - authentication failed (missing/invalid/revoked token)
* `402 subscription_required` - active Creator/Professional/Business plan required
* `403 tier_not_allowed` - Scheduler tier cannot use Partner API
* `500 folder_items_add_failed` - unexpected failure