---
title: "Create media"
method: POST
path: "/medias"
tags: ["Media"]
---

# Create media

`POST /medias`

## Headers

- `channel` string, required
- `organization` string, required

## Request body

- CreateMediaInput
  - `filename` string, required — File name
  - `status` 'Uploading' | 'Uploaded' | 'Transcoding' | 'Ready' | 'Ingest' | 'Processing' | 'Complete' | 'ImageComplete' | 'AudioComplete' | 'SubtitleComplete', required — The current status of this media content on the platform. Enum
  - `type` 'Video' | 'Image' | 'Audio' | 'Livestream' | 'Subtitle', required — The type of media content. Enum
  - `upload` string — Upload ID
  - `duration` number, required — Duration of video or audio content
  - `width` number, required — Width of image
  - `height` number, required — Height of image
  - `aspectRatio` string, required — Aspect ration of visual content
  - `orientation` 'landscape' | 'portrait', required — Orientation of visual content. Enum
  - `baseUrl` string, required
  - `imgPath` string, required
  - `dashPath` string, required
  - `hlsPath` string, required
  - `mp4VodUrl` string, required
  - `mp4Path` string, required
  - `vttPath` string, required
  - `thumbnailPath` array[], required
    - unknown[]
      - unknown
  - `locale` string — ISO 639-1 leanguage code

## Response `201`

Returns a ResponseMediaOutput object with the metadata for the new media.

- ResponseMediaOutput
  - `id` string, required
  - `createdAt` string, date-time, required
  - `filename` string, required
  - `channel` string, required
  - `account` string, required
  - `type` 'Video' | 'Image' | 'Audio' | 'Livestream' | 'Subtitle', required — Media content type. Enum
  - `status` 'Uploading' | 'Uploaded' | 'Transcoding' | 'Ready' | 'Ingest' | 'Processing' | 'Complete' | 'ImageComplete' | 'AudioComplete' | 'SubtitleComplete', required — The current status of the media content on the platform. Enum
  - `upload` string, required
  - `isAvatar` boolean, required
  - `duration` number, required — Duration of video or audio content
  - `width` string, required — Width of image
  - `height` string, required — Height of image
  - `aspectRatio` string, required — Aspect ratio of visual content
  - `orientation` 'landscape' | 'Image' | 'portrait', required — Orientation of visual content
  - `baseUrl` string, required
  - `dashPath` string, required
  - `hlsPath` string, required
  - `mp4Path` string, required
  - `thumbnailPath` string[], required
  - `label` string[], required

---

[API](https://skmtc.net/fanhero/apis/tenant-endpoints.md) · [All operations](https://skmtc.net/fanhero/apis/tenant-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanhero/tenant-endpoints/versions/8e7584c449dc/schema)