BeiträgeEinen Beitrag bearbeiten
Zurück zu Sofia

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}
PATCH/v1/posts/{id}

Diese Anfrage wirkt auf Ihr echtes Konto.

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"}'

Autorisierungen

  • Authorizationstringerforderlich

    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

200application/json

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

402

subscription_required.

403

live_mode_required bei einer Test-Anwendung, oder die Berechtigung posts:write fehlt.

404

post_not_found: außerhalb der Reichweite des Tokens.

409

post_not_editable: Ein Netzwerk hat den Beitrag gesendet oder sendet ihn gerade.

422application/json

post_refused: Ein Netzwerk, der Betrieb oder Publishing würde den bearbeiteten Beitrag ablehnen. duplicate_platform bei zwei Zielen auf einem Netzwerk.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.