---
title: "Creates an upload"
method: POST
path: "/uploads.json"
tags: ["Uploads"]
---

# Creates an upload

`POST /uploads.json`

## Response `200`

file uploaded

- object
  - `id` integer, required
  - `url` string, required
  - `original_filename` string, required
  - `filesize` integer, required
  - `width` integer, required
  - `height` integer, required
  - `thumbnail_width` integer, required
  - `thumbnail_height` integer, required
  - `extension` string, required
  - `short_url` string, required
  - `short_path` string, required
  - `retain_hours` string, nullable, required
  - `human_filesize` string, required
  - `dominant_color` string, nullable
  - `thumbnail` object, nullable
    - `id` integer
    - `upload_id` integer
    - `url` string
    - `extension` string
    - `width` integer
    - `height` integer
    - `filesize` integer
  - `optimized_video` object, nullable
    - `id` integer
    - `upload_id` integer
    - `url` string
    - `extension` string
    - `filesize` integer
    - `sha1` string
    - `original_filename` string

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)