REST APIPATCH

Update Post

Update a scheduled post by sending only the fields you want to change; the API returns the full updated post object.

PATCHhttps://post.adaptlypost.com/post/api/v1/social-posts/:id

Update an existing post. All fields are optional, only send the fields you want to change. Returns the full updated post.

API Key (Bearer token)
Permission:posts.draftRoles and permissions

Editing a draft needs posts.draft. Editing a scheduled post needs posts.schedule. A post created by another member also needs posts.others, which Contributors do not have.

Body Parameters

ParameterTypeDescription
platformsPlatformType[]Target platforms
contentTypeContentTypeTEXT, IMAGE, VIDEO, CAROUSEL, or DOCUMENT. DOCUMENT is LinkedIn only: exactly one PDF, PPT, PPTX, DOC or DOCX file in mediaUrls, shown as a swipeable document
textstringPost text content. On LinkedIn, mention a company page with @[Page Name](urn:li:organization:<id>), using the page name exactly as LinkedIn shows it. LinkedIn only allows mentions of company pages, not people. GET /api/v1/linkedin-organizations/lookup (see Social Accounts) returns that mention for a page URL or vanity name
platformTextsPlatformText[]Per-platform text overrides
mediaUrlsstring[]URLs of uploaded media files
mediaAltTextsstring[]Alt text for each image, in the same order as mediaUrls. Max 1000 characters each; use an empty string to skip an image. Sent to X, Bluesky, Mastodon, Tumblr, WordPress, LinkedIn, Facebook, Instagram and Threads. Pinterest uses the first one, cut to 500 characters. TikTok, YouTube, Google Business Profile and videos ignore it.
thumbnailUrlstringThumbnail of a video post, as an https URL or an image data URI. Every platform that takes a thumbnail uses it unless platformThumbnails overrides it
thumbnailTimestampMsnumberVideo frame to use as the thumbnail, in milliseconds from the start. Works on YOUTUBE, FACEBOOK, INSTAGRAM, LINKEDIN, PINTEREST, TELEGRAM and TIKTOK. A thumbnailUrl sent with it wins everywhere except TIKTOK, which takes only a frame. platformThumbnails overrides both
platformThumbnailsPlatformThumbnail[]A different thumbnail per platform, as on create. Sending the list replaces every override; leaving it out keeps the stored ones
platformMediaPlatformMedia[]Its own media per platform, as on create. Sending the list replaces every override, [] clears them all and leaving it out keeps the stored ones. It applies even when platforms is not sent
platformAspectRatiosPlatformAspectRatio[]Image shape per platform, as on create. It applies to the mediaUrls sent in the same request
firstCommentsPlatformFirstComment[]First comments per platform, as on create. Sending the list replaces every stored comment and an empty list clears them; leaving it out keeps the stored ones
threadRepliesPlatformThreadReplies[]Threads per platform, as on create. Sending the list replaces every stored thread and an empty list clears them; leaving it out keeps the stored ones
scheduledAtstringNew schedule time (ISO 8601). null takes the planned date off a draft, or off a post that failed everywhere, and moves it off the calendar; on a scheduled post null returns 400, use Unschedule Post instead. Leaving the field out keeps the current date
timezonestringIANA timezone
pageIdsstring[]Facebook pages to post to. Accepts either the account id or the pageId from /social-accounts
twitterConnectionIdsstring[]Twitter account connection IDs
twitterKeepLinksbooleanKeep links in the X text clickable, as on create. Leaving it out keeps the stored value
linkedinConnectionIdsstring[]LinkedIn account connection IDs
instagramConnectionIdsstring[]Instagram account connection IDs
tiktokConnectionIdsstring[]TikTok account connection IDs
youtubeConnectionIdsstring[]YouTube channel connection IDs
pinterestConnectionIdsstring[]Pinterest account connection IDs
blueskyConnectionIdsstring[]Bluesky account connection IDs
mastodonConnectionIdsstring[]Mastodon account connection IDs
googleBusinessConnectionIdsstring[]Google Business Profile location connection IDs
googleBusinessConfigsGoogleBusinessConfig[]Google Business Profile post settings per location: post type (update, event or offer), button, event dates and offer details. See Platform Configs for schema
tumblrConnectionIdsstring[]Tumblr blog connection IDs
wordpressConnectionIdsstring[]WordPress site connection IDs
telegramConnectionIdsstring[]Telegram channel and group connection IDs
tumblrConfigsTumblrConfig[]Tumblr post settings per blog: tags, title and source link. See Platform Configs for schema
wordpressConfigsWordPressConfig[]WordPress post settings per site: title, excerpt, categories, tags and status. See Platform Configs for schema
threadsConnectionIdsstring[]Threads account connection IDs
pinterestConfigsPinterestConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
tiktokConfigsTikTokConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
instagramConfigsInstagramConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
facebookConfigsFacebookConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
youtubeConfigsYouTubeConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
linkedinConfigsLinkedInConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
twitterConfigsTwitterConfig[]Settings for this platform, one object per account, each naming the connectionId it applies to (pageId for Facebook). See Platform Configs
All fields are optional. Only include the fields you want to update. The response returns the full updated post object.

Editing a failed post

A post that failed on every platform becomes a draft again when you update it, with its platforms back to pending. Publish or schedule it with Publish Draft. A post that published on some platforms and failed on others cannot be edited: retry the failed platforms instead.

Rescheduling into the past

Moving a scheduled post's scheduledAt more than a minute into the past returns 400 "The new scheduled time is in the past. Choose a time in the future". To publish it right away, use Publish Draft.

One Account per Platform

Only one account per platform is allowed per post. You cannot update a post to include multiple accounts on the same platform. This restriction is enforced to comply with platform Terms of Service.
Update a Social Post
curl --request PATCH \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/post_xyz789 \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "Updated post content!",
    "platforms": ["TWITTER", "LINKEDIN"],
    "scheduledAt": "2026-03-15T10:00:00Z",
    "timezone": "America/New_York",
    "twitterConnectionIds": ["conn_abc123"],
    "linkedinConnectionIds": ["conn_def456"]
  }'
200
{
  "id": "post_xyz789",
  "contentType": "TEXT",
  "text": "Updated post content!",
  "status": "SCHEDULED",
  "scheduledAt": "2026-03-15T10:00:00Z",
  "timezone": "America/New_York",
  "platforms": [
    {
      "id": "pp_001",
      "platform": "TWITTER",
      "status": "PENDING",
      "accountName": "@yourhandle"
    },
    {
      "id": "pp_002",
      "platform": "LINKEDIN",
      "status": "PENDING",
      "accountName": "Your Company"
    }
  ],
  "createdAt": "2026-03-14T11:59:00Z",
  "updatedAt": "2026-03-15T08:30:00Z"
}