---
title: "Upload media: POST /upload | Posty dokumentáció"
description: "Kép vagy videó feltöltése a médiatárba, legfeljebb 1 GB."
canonical: https://posty.hu/en/docs/api/endpoints/media-feltoltes
source: https://posty.hu/en/docs/api/endpoints/media-feltoltes.md
---

Media

# Upload media: POST /upload

Kép vagy videó feltöltése a médiatárba, legfeljebb 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 | törzs | 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_a_kulcsod" \
  -F "file=@kep.png"
```

Kód másolása

## 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/kep.png"
}
```

Kód másolása

## 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.