---
title: "Copies the specified documents."
method: POST
path: "/authoring/v1/copy/sync"
tags: ["Authoring Import"]
---

# Copies the specified documents.

`POST /authoring/v1/copy/sync`

Use the `/authoring/v1/copy/sync` endpoint to copy the specified documents for the current tenant.
Currently supported document classifications are `asset` and `content`.
As for all Acoustic Content PUT and POST requests, the Content-Type header should be set to application/json.
<br />User roles: admin, manager

## Query parameters

- `referencesToClear` string
- `referencesToClone` string
- `referenceLevels` number
- `clearElementsOnLastLevel` boolean

## Headers

- `x-ibm-dx-publish-priority` 'now', string

## Request body

- string[] — The items to copy. The items need to be either ready OR belong to same project. Additional parameters "name", "add" and "remove" can be passed with each item to modify the name and add or remove a property from the copied item. Format is "[classification]:[id]?name=[custom-name];remove={\"kind\":[\"sample\"],\"description\":\"\"};add={\"kind\":[\"email\"]}" The above parameters mean that the (a) name of the copied item would be <custom-name>. (b) "email" will be added to the "kind" array in the copied object. (c) "sample" will be removed from "kind" array in the copied object. (d) "description" will be removed from the copied object.

## Response `200`

Results of the copy operation.

- object — A copy operation result.
  - `classification` 'copy' — the document classification.
  - `status` 'success' | 'failed' — the status of the copy operation.
  - `params` object — The list of query parameters applied for the copy operation.
  - `rootCopiedItemCount` integer — The number of root items copied in this request.
  - `rootCopiedItemList` object — A mapping of all root source item ids to the copied item ids.
  - `nonrootCopiedItemCount` integer — The number of non-root items copied in this request.
  - `nonrootCopiedItemList` object — A mapping of all non-root source item ids to the copied item ids.
  - `failedToCopyCount` integer — The number of source items for which the copy operation failed.
  - `failedToCopyList` object — The list of failed source item ids to failure data. Failure data format is 'isRoot:::clearElements'

## Other responses

- `400` — Tenant header (x-ibm-dx-tenant-id) not specified OR Tenant not found OR copy items belong to different projects.
- `429` — Too Many Requests, the server has reached a limit, the request must be sent again at a later time.
- `500` — Unexpected error.

---

[API](https://skmtc.net/goacoustic/apis/acoustic-content-api.md) · [All operations](https://skmtc.net/goacoustic/apis/acoustic-content-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goacoustic/acoustic-content-api/versions/677305266d89/schema)