---
title: "Upload File"
method: POST
path: "/v3/upload"
tags: ["files management"]
---

# Upload File

`POST /v3/upload`

## Request

- Base URL: `https://api.edenai.run`
- URL: `https://api.edenai.run/v3/upload`
- Auth: HTTP bearer

Upload a file for persistent storage.

Returns a file_id that can be used in subsequent API calls to /v3/universal-ai.

Files are stored securely and only accessible by the file owner.
Default expiration is 30 days, maximum 30 days.

## Request body `multipart/form-data`

- BodyUploadFileV3UploadPost
  - `file` string, binary, required: File to upload
  - `expires_in_days` integer: Expiration in days (1-30)
  - `purpose` string: Purpose of the file

## Response `200`

Successful Response

- UploadResponse: Response for a successful file upload.
  - `file_id` string, uuid, required: Unique file identifier for use in API calls
  - `file_name` string, required: Original filename
  - `file_size` integer, required: File size in bytes
  - `file_mimetype` string, required: Detected MIME type
  - `purpose` string, required: Purpose of the file (e.g., 'general', 'assistants')
  - `metadata` object: File metadata (e.g., page_count for PDFs/documents)
  - `created_at` string, date-time, required: Upload timestamp
  - `expires_at` string, date-time, nullable: Expiration timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/edenai/apis/eden-ai-api-v3.md) - [All operations](https://skmtc.dev/edenai/apis/eden-ai-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/edenai/apis/eden-ai-api-v3/revisions/20ddfd49a3f4?raw)