# Clone

Creates a copy of an item or folder with identical attributes.

- The clone gets a new id and, by default, the same sid as the original. Pass
  new_sid: true to give it one of its own.
- folder_id places the clone in a specific folder. Omit it to clone to the root level.
- include_subtree: true recursively copies all nested items when cloning a folder.

Endpoint: POST /api/v1/items/{item_id}/copy
Security: BearerAuth

## Path parameters:

  - `item_id` (number, required)
    Item ID
    Example: "2"

## Request fields (application/json):

  - `quantity` (number)
    Copy item and set this quantity

  - `folder_id` (number)
    Target folder ID. If not defined then will be moved to root

  - `include_subtree` (boolean)
    Copy with nested items or not

  - `new_sid` (boolean)
    Copy with new SID generation or not

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (number)

  - `data.name` (string)

  - `data.price` (number)

  - `data.quantity` (number)

  - `data.notes` (string)

  - `data.type` (string)

  - `data.parent_id` (number)

  - `data.created_at` (string)

  - `data.updated_at` (string)

  - `data.sid` (string)

  - `data.tag_names` (array)

  - `data.tags` (array)

  - `data.photos` (array)

  - `data.photos.url` (string, required)

  - `data.custom_attribute_values` (array)

  - `data.custom_attribute_values.custom_attribute_id` (number)

  - `data.custom_attribute_values.custom_attribute_name` (string)

  - `data.custom_attribute_values.value` (string)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)