---
title: "Create an upload"
method: POST
path: "/uploads"
tags: ["Uploads"]
---

# Create an upload

`POST /uploads`

## Request

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

## Headers

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

## Request body

- CreateUploadInput
  - `filename` string, required: The name of the file to be uploaded
  - `expireIn` number, required: The number of seconds the upload link will remain active

## Response `201`

Uploaded created.

- ResponseUploadCreation
  - `media` ResponseMediaOutput, required
    - `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
  - `upload` ResponseUploadOutput, required
    - `id` string, required
    - `createdAt` string, date-time, required
    - `account` string, required
    - `channel` string, required
    - `url` string, required
    - `bucket` string, required
    - `filename` string, required
    - `status` 'Active' | 'Deleted', required
    - `expireIn` number, 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)