投稿投稿を編集する
Sofia に戻る

投稿

投稿を編集する

送信前なら targets の置換、scheduledAt の設定、draft と scheduled の切り替えができます。

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}
PATCH/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"}'

認可

  • Authorizationstring必須

    個人キーまたは OAuth アクセストークン。Bearer <token> として送信します。

パスパラメーター

  • idstring必須

    投稿の ID。

ボディ

application/json

  • targetsobject[]

    すべてのターゲットを書き換えます（テキスト、メディア、フォーマット、アカウント）。省略すると維持されます

    子属性を表示
    • platformstring必須

      対象のネットワーク

      使用できる値： instagramfacebookxlinkedintiktok

    • textstring必須

      このネットワークで公開するキャプション

    • mediaobject[]

      添付するメディア

      子属性を表示
      • idstring

        店舗のライブラリにあるメディアの ID（なければ url と type）

      • urlstring

        メディアの公開 URL（ライブでは https）。ID がない場合

      • typestring

        URL で指定したメディアの種類

        使用できる値： imagevideo

    • formatstring

      フォーマット（post、reel、story、carousel など）。省略時はネットワークが提供するもの

    • accountIdstring

      ライブ：店舗がこのネットワークに複数のアカウントを持つ場合に、公開する連携アカウント（GET /v1/establishments/:id/accounts）

  • scheduledAtstring<date-time>

    新しい日時（未来）：この日時に投稿が予約されます

  • statusstring

    draft：下書きに戻す（内容は維持、日時は失われる）。scheduled：scheduledAt に、または元の日時で予約

    使用できる値： draftscheduled

レスポンス

200application/json

編集後の投稿。

  • idstring必須

    投稿の ID

  • statusstring必須

    全ネットワークを通じた状態。partial：一方で公開され、別の一方で失敗

    使用できる値： draftscheduledpublishingpublishedsent_to_inboxfailedpartial

  • establishmentIdstring必須

    投稿の店舗

  • createdAtstring<date-time>必須

    投稿が作成された日時

  • targetsobject[]必須

    ネットワークとアカウントごとに 1 件。1 つのネットワークに 2 アカウントなら 2 件

    子属性を表示
    • platformstring必須

      ターゲットのネットワーク

    • accountIdstring必須

      公開するアカウント（GET /v1/establishments/:id/accounts）

    • statestring必須

      ネットワーク上でのターゲットの状態

      使用できる値： draftscheduledpublishingpublishedsent_to_inboxfailed

    • publishedAtstring<date-time>

      ターゲットが公開された日時

    • permalinkstring

      ネットワーク上の公開済み投稿へのリンク

    • errorstring

      ネットワークが拒否した理由

  • scheduledAtstring<date-time>

    投稿の公開予定日時

402

subscription_required。

403

テストアプリケーションの場合は live_mode_required、または posts:write スコープがありません。

404

post_not_found：トークンが届かない投稿です。

409

post_not_editable：ネットワークがすでに送信済み、または送信中です。

422application/json

post_refused：ネットワーク、店舗、または Publishing が編集後の投稿を拒否する場合。同じネットワークに 2 つのターゲットがあると duplicate_platform。

4XXapplication/json

その他のエラー。エラーエンベロープで返されます。