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

Média

# Média feltöltése: POST /upload

Kép vagy videó feltöltése a médiatárba, legfeljebb 1 GB.

## Az útvonal

Metódus és útvonal

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

Jogosultság

`media:write`

operationId

`uploadMedia`

Kép vagy videó feltöltése a munkaterület médiatárába. A válasz tartalmazza az azonosítót és a hosztolt címet, amit a bejegyzés létrehozásakor adsz át.

Az azonos tartalmú fájlokat a szerver összevonja, így ugyanaz a kép naponta újraküldve sem hoz létre új sort és új tárolt objektumot.

## Paraméterek

| Név | Hol | Típus | Kötelező | Mit csinál |
| --- | --- | --- | --- | --- |
| file | törzs | multipart/form-data | igen | A fájl. Kép legfeljebb 10 MB (JPEG, PNG, GIF, WEBP, AVIF, BMP, TIFF), videó legfeljebb 1 GB (MP4). |

## Kérés

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

Kód másolása

## Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az [OpenAPI dokumentum](https://posty.hu/openapi.json) tartalmazza.

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

Kód másolása

## Kapcsolódó

- [Hitelesítés](https://posty.hu/dokumentacio/api/hitelesites): a kulcs és a scope-ok.
- [Hibák és korlátok](https://posty.hu/dokumentacio/api/hibak): a hibaválaszok és a hívási keret.
- [Minden végpont](https://posty.hu/dokumentacio/api/vegpontok): a teljes lista.

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@posty.hu](mailto:norbert@posty.hu) címre, vagy használd a [Segítség](https://posty.hu/segitseg) oldal űrlapját.