---
title: "Upload media: POST /upload | Posty Docs"
description: "Uploads an image or video to the media library, up to 1 GB."
canonical: https://posty.hu/en/docs/api/endpoints/upload-media
source: https://posty.hu/en/docs/api/endpoints/upload-media.md
---

Media

# Upload media: POST /upload

Uploads an image or video to the media library, up to 1 GB.

## Path

Method and path

POSThttps://api.posty.hu/public/v1/upload

Authorization

`media:write`

operationId

`uploadMedia`

Uploads an image or video to the workspace media library. The response includes the ID and the hosted URL, which you pass when you create the post.

The server deduplicates files with identical content, so sending the same image every day does not create another row or stored object.

## Parameters

| Name | Location | Type | Required | Description |
| --- | --- | --- | --- | --- |
| file | body | multipart/form-data | yes | The file. Images up to 10 MB (JPEG, PNG, GIF, WEBP, AVIF, BMP, TIFF), video up to 1 GB (MP4). |

## Request

```
curl -X POST https://api.posty.hu/public/v1/upload \
  -H "Authorization: psty_your_key" \
  -F "file=@image.png"
```

Copy Code

## Response

Example response structure. The [OpenAPI document](https://posty.hu/openapi.json) contains the authoritative schema for each field.

```
{
  "id": "cmd1a2b3c4d5",
  "path": "https://uploads.posty.hu/2026/09/image.png"
}
```

Copy Code

## Related

- [Authentication](https://posty.hu/en/docs/api/authentication): API key and scopes.
- [Errors and limits](https://posty.hu/en/docs/api/errors): error responses and rate limits.
- [All endpoints](https://posty.hu/en/docs/api/endpoints): full list.

Documentation pages

Is something missing from this page? Email [norbert@posty.hu](mailto:norbert@posty.hu) or use the form on the [Help](https://posty.hu/en/help) page.