Kommandozeile (CLI)

Beiträge über die Kommandozeile verwalten

Erstellen, auflisten, Status ändern, löschen und den nächsten freien Zeitpunkt finden, Flag für Flag.

posts:create

Diesen Befehl verwendest du am häufigsten. Die einfachste Form:

posty posts:create \
  -c "Hallo zusammen!" \
  -s "2026-12-31T12:00:00Z" \
  -i "<kanal-id>"

Option	Kurz	Was sie tut
`--content`	`-c`	Der Text des Beitrags. Wiederholt erzeugt das einen Thread, siehe unten.
`--integrations`	`-i`	Kommagetrennte Kanal-IDs.
`--date`	`-s`	Der Zeitpunkt der Veröffentlichung. ISO 8601 mit Offset, oder zusammen mit einer Zeitzone.
`--type`	`-t`	schedule (Standard), draft oder now.
`--media`	`-m`	Kommagetrennte Medien-URLs für die vorausgehende Option -c.
`--delay`	`-d`	Verzögerung zwischen den Teilen, in Minuten.
`--timezone`		IANA-Zeitzonenname, zum Beispiel Europe/Budapest.
`--settings`		Plattformspezifische Einstellungen als JSON-Text.
`--json`	`-j`	Die vollständige Anfrage aus einer JSON-Datei.
`--shortLink`		Ob Links gekürzt werden. Standardmäßig ja.

--type now veröffentlicht sofort

now braucht kein Datum und ist unumkehrbar: Der Beitrag geht an dein echtes Publikum. Teste ein Skript zuerst mit dem Typ draft.

Threads und Medien

Das erste -c ist der Beitrag. Jedes weitere ist ein Kommentar darunter. Die -m gehört immer zur vorausgehenden Option -c.

posty posts:create \
  -c "Der erste Teil" -m "https://uploads.posty.hu/eins.jpg" \
  -c "Der zweite Teil" -m "https://uploads.posty.hu/zwei.jpg" \
  -c "Der dritte Teil" \
  -d 5 \
  -s "2026-12-31T12:00:00Z" \
  -i "<kanal-id>"

Die Medien-URLs stammen aus der Antwort des Befehls posty upload. Eine beliebige URL funktioniert nicht.

Vollständige Anfrage aus einer Datei

Bei einem komplexen Beitrag, etwa mit mehreren Kanälen, anderem Text je Kanal oder Plattformeinstellungen, arbeitest du bequemer aus einer Datei:

posty posts:create --json ./beitrag.json

Der Dateiinhalt entspricht dem POST /posts Request-Body. Fertige Beispiele findest du auf der Seite Plattformbeispiele.

posts:list

posty posts:list \
  --startDate "2026-09-01T00:00:00Z" \
  --endDate "2026-09-30T23:59:59Z"

Mit der Option --customer filterst du nach Kunden. Die Ausgabe ist JSON, du kannst sie also an andere Befehle weitergeben.

posts:status

posty posts:status <beitrags-id> --status draft
posty posts:status <beitrags-id> --status schedule

Damit verschiebst du den Beitrag zwischen Entwurf und Geplant. Der Wechsel nach Geplant braucht ein Veröffentlichungsrecht, kein Entwurfsrecht.

posts:delete

posty posts:delete <beitrags-id>
posty posts:delete-group <gruppen-id>

posts:delete löscht nur diesen einen Beitrag (einen Kanal) mit seinem Thread. Die anderen Kanäle derselben Gruppe bleiben geplant. posts:delete-group löscht die ganze Gruppe auf allen Kanälen; die Gruppen-ID ist das Feld group von posts:list.

Gelöscht wird nur in Posty. Einen auf der Plattform bereits veröffentlichten Beitrag betrifft das nicht.

posts:find-slot

posty posts:find-slot <kanal-id>

Das nächste freie Zeitfenster ermittelt er aus der Zeitfenstervorlage des Kanals und den bereits geplanten Beiträgen. Für Skripte ist das der nützlichste Befehl: Frag nach, statt dir ein Datum auszudenken.

Beides zusammen

SLOT=$(posty posts:find-slot "<kanal>" | jq -r '.date')
posty posts:create -c "Hallo zusammen!" -s "$SLOT" -i "<kanal>"

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [email protected] oder nutze auf der Hilfeseite das Formular.