POST /posts

1つ以上のアカウントに向けた投稿を作成します。MCPツール：create_post。背景：承認、予約、最初のコメントとスレッド。

curl -X POST https://botdoor.co/api/v1/posts -H "Authorization: Bearer $BOTDOOR_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: launch-2026-10-12" \
  -d '{"content": "Fresh sourdough at 7am", "accountIds": ["2ae8…"], "mediaIds": ["9b1c…"],
       "scheduledFor": "2026-10-12T07:00:00+11:00", "firstComment": "Order: https://acme.example", "dryRun": true}'

フィールド

フィールド	型	備考
accountIds	string[]	必須。/accountsで取得したID
content	string	投稿の本文
mediaIds	string[]	/mediaで取得したID。複数指定するとカルーセルになります。mediaId（文字列1つ）も使えます
dryRun	boolean	検証のみ。保存、送信、カウントは一切行われません
scheduledFor	string	オフセット付きのISO 8601。1年以内の日時。省略すると今すぐ投稿します
requireApproval	boolean	trueなら必ず承認を待ちます。falseでも承認制キーの承認は省略できません
firstComment	string	投稿の公開から約10秒後に、同じアカウントから返信します。リンクはここに入れてください
thread	string[]	続きの投稿（X、Threads、Bluesky）。thread[0]が最初の返信です
firstReply	string	要素が1つのthreadの別名。threadとは併用できません
poll	object	{options, durationMinutes, question}。XまたはLinkedIn、メディアなしの場合のみ。questionはLinkedInのみ
cover	object	動画のカバー画像：{mediaId}（画像のアップロード）または{offsetMs}（フレーム）
tiktokAiGenerated	boolean	TikTok：AI生成コンテンツとしてラベル付けします

Idempotency-Keyヘッダー：同じキーで再試行しても、二重に投稿されることはありません。

レスポンス

• 200 ドライラン：{"dryRun": true, "valid": true, "warnings": [], "requireApproval": true, "wouldPost": {…}}
• 201 作成：{"post": {…}}。statusはneeds_approval、scheduled、publishing、published、failedのいずれかです。形式：GET /posts/{id}。
• replayed: true付きの200：以前の投稿と同じIdempotency-Keyです。

エラー

ステータス	コード	意味
400	validation_failed	フィールドがない、または形式が正しくない。details.fieldsを確認してください
400	invalid_date、scheduled_in_past、scheduled_too_far	scheduledForが不正
400	media_required	Instagram、TikTok、YouTube、Pinterestにはメディアが必要
400	thread_unsupported、poll_unsupported、first_comment_unsupported、cover_unsupported	投稿先がその機能に対応していない
400	tiktok_privacy_conflict、tiktok_ai_unsupported	TikTokの設定が競合している
400	upstream_rejected	SNS側がコンテンツを拒否した
403	plan_feature_unavailable、post_limit_reached	プランの制約（X、Freeでは月30件の投稿）
404	account_not_found、media_not_found	IDがこのワークスペースに存在しない
409	no_accounts_connected、account_needs_reconnection	先に連携または再連携が必要
409	media_expired	アップロードから7日以上経過している
409	duplicate_content	同じ本文をそのアカウントに投稿した直後
409	tiktok_cannot_post	TikTokによると、クリエイターは現在投稿できない。再試行可能
422	idempotency_key_reused	同じキーで異なるボディ