Posts

Unschedule a post

Changed on

Turns a scheduled or dated draft post back into an undated draft. Requires the posts.draft permission.

post/social-posts/{id}/unschedule

Request

  • Base URL: https://post.adaptlypost.com/post/api/v1
  • URL: https://post.adaptlypost.com/post/api/v1/social-posts/{id}/unschedule
  • Auth: HTTP bearer

Path parameters

idstring required

Post ID

Headers

X-Workspace-Idstring

The workspace to act in, for OAuth sign-ins that reach several workspaces. Take the id from GET /workspaces. Without it the call lands in the default workspace. A workspace the caller cannot reach answers 403 with code: workspace_access_denied. An API key belongs to one workspace: send its own id or leave the header out

Response

The post as an undated draft

idstring
createdAtstring date-time
updatedAtstring date-time
userIdstring
contentType'TEXT' | 'IMAGE' | 'VIDEO' | 'CAROUSEL' | 'DOCUMENT'

CAROUSEL takes 2 or more items in mediaUrls, up to 4 on TWITTER, BLUESKY and MASTODON, 5 on PINTEREST, 10 on INSTAGRAM, FACEBOOK and THREADS, 20 on LINKEDIN, 30 on TUMBLR and 35 on TIKTOK. A TIKTOK carousel takes JPEG or WebP photos only. INSTAGRAM and THREADS accept images and videos in the same carousel; every other platform takes images only, and YOUTUBE has no carousel. DOCUMENT publishes one PDF, PPT, PPTX, DOC or DOCX file (max 100 MB, 300 pages) as a LinkedIn document post, and is LinkedIn only: any other platform in the same request is rejected with a 400

textstring
scheduledAtstring date-time
timezonestring
status'DRAFT' | 'SCHEDULED' | 'PENDING' | 'PUBLISHING' | 'COMPLETED' | 'PARTIAL_FAILURE' | 'FAILED'
thumbnailUrlstring
thumbnailTimestampMsnumber

Video frame timestamp (ms) used as the thumbnail

mediaUrlsstring[]

The media as submitted, shared by every platform entry. See mediaUrls on PostPlatform for how these change after publishing

mediaAltTextsstring[]
recurringPostIdstring

The recurring post this post is an occurrence of

occurrenceAtstring date-time

The slot of the series this post fills. Stays the same when the post is rescheduled

Changes

  • 8390a5fa9a0dRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status