---
title: "Copy Folder"
method: POST
path: "/folders/{id}/copy"
tags: ["Folders"]
---

# Copy Folder

`POST /folders/{id}/copy`

## Request

- Base URL: `https://api.wistia.com/modern`
- URL: `https://api.wistia.com/modern/folders/{id}/copy`
- Auth: HTTP bearer

This copies a folder (previously called project) and all its media and subfolders asynchronously in a background job.

This method does not copy the folder’s sharing information (i.e. users that could see the old folder will not automatically be able to see the new one).

For the request you can specify the owner of a new folder by passing an optional parameter. The person you specify must be a Manager in the account.

The body of the response will contain an object representing the background job that was created.

## Requires api token with one of the following permissions
```
Read, update & delete anything
```

Tokens with the "Act with a team member's permissions" permission
(`all:delegate_to_contact_permissions` scope) can also be used. Requests
made with such a token are authorized using the permissions of the
contact assigned to the token.

## Path parameters

- `id` string, required: Hashed ID of the folder (e.g., "4d23503f70")

## Headers

- `X-Wistia-API-Version` string, required

## Request body

- object
  - `adminEmail` string: The email address of the account Manager that will be the owner of the new folder. Defaults to the Account Owner if invalid or omitted.

## Response `202`

Folder queued to be copied

- object: A background job keeps track of the progress of an asynchronous task, e.g bulk archiving media, translating media, etc.
  - `id` integer, required: The ID of the background job that's been queued for the request.
  - `hashed_id` string, required: The unguessable hashed ID of the background job. Prefer this over the numeric ID when polling for status.
  - `status` 'queued' | 'started' | 'finished' | 'failed', required: The status of the background job that's been queued for the request.

## Other responses

- `401`: Unauthorized, invalid or missing token
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-11-03** `b86cb2a7b420`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/folders/:id/copy/post.md)

---

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