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

# Create media

`POST /medias`

## Request

- Base URL: `https://api.fanheroapi.com`
- URL: `https://api.fanheroapi.com/medias`
- Auth: API key in header `apiKey`

## 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.dev/fanhero/apis/headless-cms-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/headless-cms-endpoints/revisions/fb8d50c05ee6?raw)