approve_post
ChatGPTExplicitly approve the current revision of a post. Requires Approve permission, a caption and media. Opening or reading a post does not approve it. Does not publish or send notifications.
cancel_upload
ChatGPTCancel an unfinished upload selected by the user. Ready media is preserved.
complete_upload
ChatGPTFinish a multipart upload with its ordered PartNumber and ETag values. The file is processed afterwards and is usable once its upload status is ready. Safe to retry.
connection_profile
ChatGPTIdentify the connected Planner account without exposing other members.
create_folder
ChatGPTCreate a manual Library folder, optionally grouping existing assets without duplicating their files. Requires Manage content.
create_post
ChatGPTCreate a draft with title, caption, ordered existing media IDs and local calendar date/time. Requires Manage content. Carousel posts automatically appear as Library folders. Applies the brand's saved New Post notification defaults. Does not approve or publish.
delete_folder
ChatGPTDelete a manual Library folder while preserving all its media files and posts. Automatic carousel folders cannot be deleted independently.
delete_post
ChatGPTPermanently 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.
get_capabilities
ChatGPTRead this connection's workspaces, brand scope, per-brand editorial permissions, consented actions (withdraw approval, delete post, mark published), download policy and each brand's time zone.
get_caption_style
ChatGPTRead the brand's editable caption-writing guide. Does not generate text or use credits.
get_post
ChatGPTRead one post and its current revision. Edits, approvals and other changes to the post must reference that exact revision.
list_brands
ChatGPTList brands available to this Planner connection, with the workspace each belongs to.
list_folders
ChatGPTList manual Library folders and automatic carousel folders, including ordered asset IDs. A folder with postId is maintained by editing that carousel post.
list_media
ChatGPTList Library media for an assigned brand. Private files are never included. downloadAllowed tells whether the original can be downloaded in the Planner app.
list_posts
ChatGPTList posts with titles, captions, schedule, status, versions and revisions for an assigned brand. Does not record a review or approval.
list_workspaces
ChatGPTList the workspaces this connection may use, with your role and the consented brands in each.
mark_post_published
ChatGPTRecord 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. Notifies no one.
rename_folder
ChatGPTRename a manual Library folder. Automatic carousel folders take their name from the post title.
set_folder_assets
ChatGPTAdd existing assets to, or remove them from, a manual Library folder. Does not duplicate or delete files. Automatic carousel folders follow their post's media order.
set_frame_as_thumbnail
ChatGPTReplace 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.
start_upload
ChatGPTStart 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.
thumbnail_status
ChatGPTCheck a frame-thumbnail request by its requestId. Complete means the selected frame is active; superseded means a newer selection replaced this request.
update_caption_style
ChatGPTSave 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_post
ChatGPTUpdate 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. Published posts cannot be edited.
upload_media
ChatGPTImport 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_part_url
ChatGPTGet 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_status
ChatGPTCheck whether an upload finished validation. Media can be attached to posts once its status is ready.
upload_thumbnail
ChatGPTReplace 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.
withdraw_approval
ChatGPTReturn an approved post to In review without creating a version; its approval history is kept and the Publish kit locks until someone approves again. Requires Approve permission and this connection's consent for withdrawing approvals. Published posts keep their approval. Notifies no one.