---
title: "URL File Upload"
method: POST
path: "/api/v1/files/upload/url"
tags: ["File Upload"]
---

# URL File Upload

`POST /api/v1/files/upload/url`

- Upload by providing a remote file URL
- System will automatically download and store the remote file
- Suitable for migrating files from other servers
- Files will expire after 72 hours
- Current user quota is limited. Uploads will fail when quota is exhausted. Please save locally if persistent storage is needed

**Note:**
The file upload API base URL is`https://files-api.evolink.ai`

## Request body

- UrlUploadRequest
  - `file_url` string, uri, required — Remote file URL **Requirements:** - Must be a publicly accessible URL - Supports HTTP and HTTPS protocols - System will automatically download the file content from this URL - Maximum `1` image per request - Currently supports uploading files in: `image/jpeg`, `image/png`, `image/gif`, `image/webp` formats only
  - `upload_path` string — Custom upload path **Note:** - If not specified, system will automatically categorize based on file type
  - `file_name` string — Custom file name **Note:** - If not specified, system will automatically generate a unique file name

## Response `200`

File uploaded successfully

- FileUploadResponse
  - `success` boolean — Whether the request was successful
  - `code` integer — Response status code
  - `msg` string — Response message
  - `data` FileData
    - `file_id` string — Unique file identifier
    - `file_name` string — Stored file name
    - `original_name` string — Original file name
    - `file_size` integer — File size (bytes)
    - `mime_type` string — File MIME type
    - `upload_path` string — File storage path
    - `file_url` string, uri — File access URL
    - `download_url` string, uri — File download URL
    - `upload_time` string, date-time — Upload time (ISO 8601 format)
    - `expires_at` string, date-time — File expiration time (ISO 8601 format)

---

[API](https://skmtc.dev/evolink/apis/get-credits-usage-api.md) · [All operations](https://skmtc.dev/evolink/apis/get-credits-usage-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolink/get-credits-usage-api/revisions/88edb0ec881f/schema)