Update a post

Edits a draft or scheduled post. Published, processing, and partially published posts cannot be edited.

Category: Posts
Calls: PUT/v1/posts/{id}
Safe to auto-approve: No. It changes data, so keep a human in the loop or scope the key.

Parameters

idstringrequired

Post id to update.

profileIdstringoptional

Profile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.

contentstringoptional

Post text or caption.

object[]optional

Images or a video. Upload with upload_media first.

accountIdsstring[]optional

Account `id` values from list_accounts.

scheduledAtstringoptional

ISO 8601 datetime to publish at, for example 2026-08-01T12:00:00Z.

publishNowbooleanoptional

Publish immediately. Omit together with scheduledAt to save a draft.

platformsobjectoptional

Per-platform options keyed by platform name.

Example

A tool call as an MCP client would send it.

{
  "name": "update_post",
  "arguments": {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "content": "Shipping today.",
    "accountIds": [
      "string"
    ]
  }
}