---
title: "Create media asset"
method: POST
path: "/v2/assets"
tags: ["Assets"]
---

# Create media asset

`POST /v2/assets`

Creates a media asset with support for multipart or direct url upload. This endpoint currently supports only the dubbing configuration.

## Request body

- CreateAssetRequest
  - `contentType` 'video/mp4' | 'video/webm' | 'video/quicktime', required — The content type of the asset to upload. Must be one of: video/mp4, video/webm, or video/quicktime.
  - `configuration` DubbingAssetRequestConfiguration, required — Public API configuration for dubbing assets.
    - `name` 'dubbing'
    - `detectLanguage` boolean — Whether to detect the language of the asset.
  - `contentLength` integer, nullable — The length of the file content to upload. This is used to verify the integrity of the asset during upload.
  - `contentMD5` string, nullable — The MD5 hash of the file content to upload. This is used to verify the integrity of the asset during upload.
  - `title` string — The title of the asset to upload.

## Response `201`

Created. Returns upload credentials for the multipart upload.

- CreateAssetMultipartUploadResponse
  - `id` string, required
  - `uploadUrl` string, nullable
  - `uploadCredentials` MultipartUploadCredentialsResponse, required
    - `accessKeyId` string, required
    - `secretAccessKey` string, required
    - `sessionToken` string, required
    - `bucket` string, required
    - `key` string, required

## Other responses

- `400` — Unsupported Media Type.
- `default` — Unexpected Server error.

---

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