8digit Planner

Permanently delete one post and its automatic carousel folder. Library files are kept. Requires Manage content and this connection's consent for deleting posts. Deleting a published post also removes its publication record in Planner; nothing is removed from social networks. Notifies no one.

delete_post

Read this connection's workspaces, brand scope, per-brand editorial permissions, consented actions (withdraw approval, delete post, mark published, publish automatically), download policy and each brand's time zone. workspaces[].service carries the workspace's phase; in a trial with no posts yet, service.nextStep says what to propose next. workspaces[].features lists autoposting where Planner can publish to the brand's social accounts.

get_capabilities

Read one post and its current revision. Edits, approvals and other changes to the post must reference that exact revision. autopublish says where Publish automatically stands; publication.links has each account's link or error once Planner published it.

get_post

Get a temporary private HTTPS PUT URL for one upload part, valid about 15 minutes. The part's bytes are sent to it with PUT, and the response's ETag header identifies the stored part. The URL carries its own authorization and needs no Planner credentials.

upload_part_url

Import a user-selected or generated image or video, provided by the host as a file reference, into the brand's Planner Library, up to 50 MB. Local paths and base64 are not accepted. Does not create a post; the file is usable once processing finishes. Retries with the same requestId do not create duplicates. No upload notifications.

upload_media

List brands available to this Planner connection, with the workspace each belongs to.

list_brands

List manual Library folders and automatic carousel folders, including ordered asset IDs. A folder with postId is maintained by editing that carousel post.

list_folders

List Library media for an assigned brand. Private files are never included. downloadAllowed tells whether the original can be downloaded in the Planner app.

list_media

List posts with titles, captions, schedule, status, versions, revisions and, when it is on, Publish automatically (accounts and status: scheduled, publishing, published or not-published with its reason) for an assigned brand. Does not record a review or approval.

list_posts

List the social accounts connected to a brand for Publish automatically, with each account's ID, network, name and status. An account with status reconnect must be reconnected in Planner before posts go out to it. Accounts are connected in Planner's Social accounts, not through this connection.

list_social_accounts

List the workspaces this connection may use, with your role and the consented brands in each.

list_workspaces

Record that the approved current version was published manually. Requires Publish permission, this connection's consent for marking posts published, the exact current revision and an https://instagram.com/ (or www.instagram.com) link to a p/, reel/ or stories/ page. Does not publish anything or verify that the link matches the content, and turns off Publish automatically for the post. Notifies no one.

mark_post_published

Turn on Publish automatically for a post: at its date and time, in the brand's time zone, it goes out to the chosen social accounts of its brand if its current version is approved by then. Use the IDs of the brand's connected social accounts; an empty list turns it off. Requires Publish permission, this connection's consent for publishing automatically, a future date and time and the exact current revision. Does not approve the post and never publishes without approval. Each plan's allowance of automatic posts applies when the post goes out. If it doesn't go out, whoever scheduled it gets an email with the reason.

set_autopublish

Publish a post now to the social accounts already chosen for Publish automatically, or retry the accounts that failed. Requires Publish permission, this connection's consent for publishing automatically, an approved current version and the exact current revision. Publishing takes a few moments: read the post again for its status and each account's link or error. Planner cannot delete a published post from a social network. If it doesn't go out, whoever scheduled it gets an email with the reason.

publish_post_now

Read the brand's editable caption-writing guide. Does not generate text or use credits.

get_caption_style

Rename a manual Library folder. Automatic carousel folders take their name from the post title.

rename_folder

Replace an existing Planner video's thumbnail with a selected or generated JPG, PNG or WebP image up to 10 MB, provided by the host as a file reference. Requires Manage content. Local paths and base64 are not accepted. Returns an uploadId; the thumbnail changes once processing finishes. Does not add Library media or send notifications.

upload_thumbnail

Save a guide supplied or written by the user or their assistant. Requires brand administration authority, brand consent and caption permission. Read the current revision first. No AI generation or credits.

update_caption_style

Replace the thumbnail of an existing Planner video with the frame at timeSeconds. Requires Manage content for its brand. Does not create Library media or change post revisions, comments or approval. Returns a requestId; the frame is applied asynchronously.

set_frame_as_thumbnail

Start or resume a multipart upload of an explicitly selected local image or video up to 1 GB, sent in parts from the environment that holds the file. With thumbnailAssetId, the upload (a JPG, PNG or WebP up to 10 MB) replaces that video's thumbnail and requires Manage content. Retries with the same requestId return the same upload. Does not create posts or notify anyone.

start_upload

Update any supplied title, caption, format, schedule or ordered media IDs; omitted fields are preserved. Requires Edit captions for caption-only changes, or Manage content for other changes, and the exact current revision. Caption/media changes create a version and clear approval; schedule changes preserve approval and move Publish automatically to the new time. Published posts cannot be edited.

update_post

Return an approved post to In review without creating a version; its approval history is kept, and the Publish kit and Publish automatically wait until someone approves again. Requires Approve permission and this connection's consent for withdrawing approvals. Published posts keep their approval. Notifies no one.

withdraw_approval