---
title: "Upload a file"
method: POST
path: "/v1/uploads"
tags: ["Uploads"]
---

# Upload a file

`POST /v1/uploads`

Uploads a temporary media file that can be referenced in API generation requests. The uploaded files will be automatically expired and deleted after a period of time. It is strongly recommended to use our SDKs for this which have a simplified interface that directly accepts file objects.

## Headers

- `X-Runway-Version` '2024-11-06', required

## Request body

- object
  - `filename` string, required — The filename of the file to upload. Must have a valid extension and be a supported media type (image, video, or audio).
  - `type` 'ephemeral', required — The type of upload to create

## Response `200`

The upload URL and Runway URI have been successfully created.

- object
  - `uploadUrl` string, uri, required — The URL to upload your media file to with a POST request.
  - `fields` object, required — Fields that must be included in the file upload request as form data.
  - `runwayUri` string, required — The Runway upload URI to use in other API generation requests

## Other responses

- `429` — You have exceeded the rate limit for this endpoint.

---

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