---
search:
  tags:
    - File Uploads
    - POST
seo:
  description: >-
    Uploads a file by downloading it from the provided URL. The file will be
    processed… Reference for the POST /uploads endpoint in the Ordinal API.
sidebar:
  label: Upload a file from a URL
  badge: POST
title: Upload a file from a URL
type: openapi-operation
---
Uploads a file by downloading it from the provided URL. The file will be processed asynchronously. Poll the GET endpoint to check when it's ready, then use the returned assetId in post creation.

**Supported file types:**
- Images: JPEG, PNG, GIF, WebP
- Videos: MP4, QuickTime (MOV)

**File size limits:**
- Images: 10 MB max
- GIFs: 15 MB max
- Videos: 350 MB max

**Additional constraints:**
- Images cannot exceed 36 megapixels
- URL must be publicly accessible

`POST /uploads`