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

# Create an upload

`POST /uploads`

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