---
title: "Copy Media"
method: POST
path: "/medias/{mediaHashedId}/copy"
tags: ["Media"]
---

# Copy Media

`POST /medias/{mediaHashedId}/copy`

## Request

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

This endpoint copies a media and its assets to a destination folder (defaults to source media).

## 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

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

## Headers

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

## Request body

- object
  - `folder_id` integer: The ID of the folder where you want the new copy placed. Defaults to the source media’s current folder if omitted or invalid.
  - `owner` string, email: An email address specifying the owner of the new media. Defaults to the source media’s current owner if omitted or invalid.

## Response `201`

Successful creation of the media copy.

- object: A media generally represents a video or an audio which can be embedded into your website. CDN-backed medias are accessible using this url structure: https://fast.wistia.com/embed/medias/{hashed_id}.m3u8. For more information, see https://docs.wistia.com/docs/asset-urls#getting-hls-assets.
  - `id` integer: A unique numeric identifier for the media within the system.
  - `name` string: The display name of the media.
  - `type` 'Video' | 'Audio' | 'Image' | 'PdfDocument' | 'MicrosoftOfficeDocument' | 'Swf' | 'UnknownType': A string representing what type of media this is.
  - `archived` boolean: Whether or not the media is archived, either true or false.
  - `created` string, date-time: The date when the media was originally uploaded.
  - `updated` string, date-time: The date when the media was last changed.
  - `duration` number, nullable: Specifies the length (in seconds) for audio and video files. Specifies number of pages in the document. Omitted for other types of media.
  - `embedCode` string: DEPRECATED: If you want to programmatically embed videos, follow the construct an embed code guide.
  - `hashed_id` string: A unique alphanumeric identifier for this media.
  - `description` string: A description for the media which usually appears near the top of the sidebar on the media's page.
  - `progress` number: A floating point value between 0 and 1 that indicates the progress of the processing for this file.
  - `status` 'queued' | 'processing' | 'ready' | 'failed': Post upload processing status. - `queued`: the file is waiting in the queue to be processed. - `processing`: the file is actively being processed. - `ready`: the file has been fully processed and is ready for embedding and viewing. - `failed`: the file was unable to be processed (usually a format or size error).
  - `section` string, nullable: The title of the section in which the media appears. This attribute is omitted if the media is not in a section (default).
  - `thumbnail` object
    - `url` string
    - `width` integer
    - `height` integer
  - `protected` boolean, nullable: Whether the media is protected (e.g. requires a password or other authentication to view). Null if the media is not protected.
  - `folder` object, nullable, required
    - `id` integer: A unique numeric identifier for the folder within the system.
    - `name` string: The folder’s display name.
    - `hashed_id` string: A private hashed id, uniquely identifying the folder within the system.

## Other responses

- `400`: Bad request, e.g. copy failure.
- `401`: Unauthorized, invalid or missing token
- `403`: Forbidden, token is valid but account does not have access to feature
- `404`: Resource not found
- `405`: Method not allowed, e.g. trying to copy archived media.
- `500`: Internal server error

## Changes

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

[Operation history](https://skmtc.dev/wistia/apis/data-api/changes/medias/:mediaHashedId/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)