Beiträge

Einen Beitrag bearbeiten

Solange kein Netzwerk zu senden begann, ersetzt es targets, setzt scheduledAt oder wechselt zwischen draft und scheduled. Fehlende Felder bleiben.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

Einen Beitrag bearbeiten

curl --request PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "id": "string",
  "status": "published",
  "establishmentId": "string",
  "scheduledAt": "2026-11-02T10:00:00.000Z",
  "createdAt": "2026-11-02T10:00:00.000Z",
  "targets": [
    {
      "platform": "instagram",
      "accountId": "string",
      "state": "published",
      "permalink": "https://www.instagram.com/p/C1"
    }
  ]
}

PATCH /v1/posts/{id} schreibt die Ziele neu, verschiebt scheduledAt oder ändert status: draft entfernt die Uhrzeit und behält den Inhalt, scheduled plant ihn neu. Sobald ein Netzwerk den Beitrag gesendet hat, ist die Antwort 409 post_not_editable.

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

Autorisierungen

Authorizationstringheadererforderlich
Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Pfadparameter

idstringerforderlich
Kennung des Beitrags.

Body

application/json

targetsobject[]
Alle Ziele, neu geschrieben (Text, Medien, Format, Konto); fehlt der Wert: beibehalten
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Ziel-Netzwerk
  Zulässige Werte: instagramfacebookxlinkedintiktok
- textstringerforderlich
  In diesem Netzwerk veröffentlichte Bildunterschrift
- mediaobject[]
  Angehängte Medien
  Untergeordnete Attribute anzeigen
  - idstring
    Kennung eines Mediums der Mediathek des Betriebs (sonst url und type)
  - urlstring
    Öffentliche Adresse des Mediums (live https); ohne Kennung
  - typestring
    Art des per Adresse angegebenen Mediums
    Zulässige Werte: imagevideo
- formatstring
  Format (post, reel, story, carousel...); standardmäßig das, das das Netzwerk liefern würde
- accountIdstring
  Live: das verbundene Konto, das veröffentlicht, wenn der Betrieb mehrere in diesem Netzwerk hat (GET /v1/establishments/:id/accounts)
scheduledAtstring<date-time>
Neues Datum in der Zukunft: Der Beitrag wird zu diesem Datum geplant
statusstring
draft: zurück zum Entwurf (behält den Inhalt, verliert die Zeit); scheduled: plant zu scheduledAt oder zur bisherigen Zeit
Zulässige Werte: draftscheduled

Antwort

Der Beitrag nach der Bearbeitung.

idstringerforderlich
Kennung des Beitrags
statusstringerforderlich
Über alle Netzwerke; partial: auf einem veröffentlicht, auf einem anderen fehlgeschlagen
Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
establishmentIdstringerforderlich
Betrieb des Beitrags
createdAtstring<date-time>erforderlich
Wann der Beitrag erstellt wurde
targetsobject[]erforderlich
Ein Eintrag pro Netzwerk und Konto: zwei Konten in einem Netzwerk, zwei Einträge
Untergeordnete Attribute anzeigen
- platformstringerforderlich
  Netzwerk des Ziels
- accountIdstringerforderlich
  Das Konto, das veröffentlicht (GET /v1/establishments/:id/accounts)
- statestringerforderlich
  Zustand des Ziels in seinem Netzwerk
  Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed
- publishedAtstring<date-time>
  Wann das Ziel veröffentlicht wurde
- permalinkstring
  Link zum veröffentlichten Beitrag im Netzwerk
- errorstring
  Warum das Netzwerk abgelehnt hat
scheduledAtstring<date-time>
Wann der Beitrag zur Veröffentlichung geplant ist

War diese Seite hilfreich?