---
title: "Medien hochladen: POST /upload | Posty Dokumentation"
description: "Lädt ein Bild oder Video in die Mediathek hoch, bis 1 GB."
canonical: https://posty.hu/de/dokumentation/api/endpunkte/medien-hochladen
source: https://posty.hu/de/dokumentation/api/endpunkte/medien-hochladen.md
---

Medien

# Medien hochladen: POST /upload

Lädt ein Bild oder Video in die Mediathek hoch, bis 1 GB.

## Der Pfad

Methode und Pfad

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

Berechtigung

`media:write`

operationId

`uploadMedia`

Lädt ein Bild oder Video in die Mediathek des Arbeitsbereichs. Die Antwort enthält die ID und die gehostete URL, die du beim Erstellen des Beitrags übergibst.

Dateien mit gleichem Inhalt fasst der Server zusammen. Dieselbe Datei täglich erneut zu schicken legt also keine neue Zeile und kein neues gespeichertes Objekt an.

## Parameter

| Name | Ort | Typ | Pflicht | Was es tut |
| --- | --- | --- | --- | --- |
| file | Body | multipart/form-data | ja | Die Datei. Bilder höchstens 10 MB (JPEG, PNG, GIF, WEBP, AVIF, BMP, TIFF), Video höchstens 1 GB (MP4). |

## Anfrage

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

Code kopieren

## Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im [OpenAPI-Dokument](https://posty.hu/openapi.json).

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

Code kopieren

## Siehe auch

- [Authentifizierung](https://posty.hu/de/dokumentation/api/authentifizierung): der Schlüssel und die Scopes.
- [Fehler und Limits](https://posty.hu/de/dokumentation/api/fehler): die Fehlerantworten und das Aufruflimit.
- [Alle Endpunkte](https://posty.hu/de/dokumentation/api/endpunkte): die vollständige Liste.

Dokumentationsseiten

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [norbert@posty.hu](mailto:norbert@posty.hu) oder nutze auf der [Hilfeseite](https://posty.hu/de/hilfe) das Formular.