Update a post

Requires scope: `posts:write`. A post that is processing or already posted cannot be edited.

Authorization

ApiKey

AuthorizationBearer <token>

A personal API key created in the dashboard (Starter, Pro, and Team plans).

In: header

Path Parameters

id*integer

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

post_contents*array<>

social_account_ids?array<integer>

scheduled_at?string

ISO 8601 UTC. Omit for a draft. Ignored when use_next_slot is true.

Formatdate-time

use_next_slot?boolean

Queue the post into the next open posting-schedule slot instead of using scheduled_at. Returns 422 NO_SLOT_AVAILABLE if no slot is open.

dry_run?boolean

Run all validations (accounts, content, char limits, scheduled_at, tier gates) and return the would-be post without persisting anything. The response carries dry_run: true.

flexible?boolean

Allow the scheduler to shift this post to the nearest open slot.

recurrence_frequency?|

Recurrence requires a paid plan.

Value in

"daily"
"weekly"
"monthly"
null

recurrence_interval?integer|null

recurrence_weekdays?array<integer>

recurrence_monthday?integer|null

repeat_until?|

Formatdate-time

recurrence_jitter_enabled?boolean

When true, each materialized occurrence is shifted by up to ±15 minutes instead of posting at the exact anchor time.

evergreen?boolean

Mark this post for evergreen recycling (re-queued into open slots after a fixed per-platform cooldown once it performs). Requires a paid plan — returns 403 TIER_UPGRADE_REQUIRED otherwise.

evergreen_variations?array<>

User-approved rewrite variants. When present, recycles cycle through these instead of AI-rewriting at publish time.

Itemsitems <= 5

Response Body

`application/json`

curl -X PATCH "https://example.com/posts/0" \  -H "Content-Type: application/json" \  -d '{    "post_contents": [      {        "platform": "twitter",        "body": "Updated copy for this post."      }    ],    "scheduled_at": "2026-07-15T16:30:00Z"  }'

{  "post": {    "id": 0,    "status": "draft",    "flexible": true,    "scheduled_at": "2019-08-24T14:15:22Z",    "posted_at": "2019-08-24T14:15:22Z",    "failed_at": "2019-08-24T14:15:22Z",    "post_error": "string",    "disconnected": true,    "source": "string",    "recurrence_jitter_enabled": true,    "evergreen": true,    "evergreen_variations": [      "string"    ],    "recycled_from_id": 0,    "reviewed_at": "2019-08-24T14:15:22Z",    "review_action": "string",    "rejection_reason": "string",    "created_at": "2019-08-24T14:15:22Z",    "body": "string",    "post_contents": [      {        "id": 0,        "platform": "twitter",        "body": "string",        "content_type": "text",        "position": 0,        "first_comment": "string",        "metadata": {}      }    ],    "post_accounts": [      {        "id": 0,        "social_account_id": 0,        "platform": "string",        "username": "string",        "platform_status": "string",        "platform_post_id": "string",        "permalink": "string",        "platform_error": "string",        "dub_short_url": "string",        "dub_original_url": "string",        "post_metric": {          "impressions": 0,          "likes": 0,          "replies": 0,          "reposts": 0,          "clicks": 0,          "engagement_rate": 0,          "fetched_at": "2019-08-24T14:15:22Z"        }      }    ],    "dry_run": true  }}

Authorization

Path Parameters

Request Body

Response Body

200application/json

401application/json

403application/json

404application/json

422application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`