---
title: Copy files
description: POST /nd/api/file/copy: Copy file interface description, including path, method, parameters and return information.
slug: api-post-nd-api-file-copy
lang: en
category: File API
category_order: 8
order: 120
api_method: POST
api_path: /nd/api/file/copy
api_label: Copy files
keywords:
  - API
  - Copy files
  - /nd/api/file/copy
---

# Copy files

`POST /nd/api/file/copy`

## POST body parameters

| Parameter | Type | Description |
| --- | --- | --- |
| `file_ids` | `ID collection` | Required source file IDs |
| `target_id` | `string` | Required destination folder ID |

## Response

Fields listed in the source: `code`, `success`, `copyKey`, `fileNum`.

The source describes file_ids as both an array and string; confirm serialization with the deployment. Use the returned copyKey with copy_progress to check completion; acceptance is not completion.

## Calling the Endpoint

Use `Authorization: Bearer <access_token>`. GET parameters belong in the URL query; normal business POST requests use JSON. Check HTTP status and then the business result. Confirm array serialization and ambiguous types with the deployment instead of inventing fields.

[Authentication](developer-api-auth.md) · [API overview](developer-api-overview.md)