---
title: "Upload a media file that can be used as inference input."
method: POST
path: "/v1/files"
tags: ["Files"]
---

# Upload a media file that can be used as inference input.

`POST /v1/files`

Upload media files to be used as inference input. Currently, only images upto 50 MB are supported.

## Response `200`

Successful Response.

- AddFileResponse — Response schema for the add file request.
  - `data` MediaAsset, required — Represents a media asset.
    - `id` string, required — The file identifier (asset_id), which can be referenced in the API endpoints.
    - `path` string, required — Local path of the file or URI with optional protocol.
    - `size` integer, required — Size of the file in bytes.
    - `duration` integer — Duration of the file in nanoseconds.
    - `contentType` string, required — MIME type of the file.

## Other responses

- `500` — The invocation ended with an error.

## Changes

- **2025-05-17** `4227e796ee0b` — 1 info
  - endpoint added
- **2025-05-16** `8fa1d4aa9217` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms/changes/v1/files/post.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms.md) · [All operations](https://skmtc.dev/nvidia/apis/nvidia-nim-for-vlms/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/nvidia-nim-for-vlms/revisions/a7f196bb2b7e/schema)