PostSyncer

Delete a media library folder by id. Nested folders and media may cascade; confirm with the user first.

delete-folder

Delete a label by ID. Posts keep their content; only the label definition is removed.

delete-label

Permanently delete a media library item by id (stored file and record). Confirm with the user first; post and comment attachments cascade. Fails if the media is still attached to a scheduled, queued, or auto-repeating post: publish it or detach the media first.

delete-media

Permanently delete a post from the PostSyncer calendar by ID. Destructive: confirm with the user and make sure they mean deleting the post, not just unpublishing it on one network.

delete-post

Extract downloadable image, video, and audio file URLs from any public social media post URL — Instagram, TikTok, YouTube, Facebook, X/Twitter, Threads, Pinterest, Reddit, LinkedIn, Vimeo, and more (same as POST /media/download/url). Works on posts you do not own or manage in PostSyncer. Nothing is stored; pass a returned file URL to upload-media-from-url to import it into the media library.

download-media-from-url

Show how one connected social account is performing, with a row per published platform post. Use to compare channels or answer questions like how is my Instagram doing.

get-analytics-account

Show how one post performed on every network it was published to (reach, views, likes, comments, shares as exposed by PostSyncer) with a per-account breakdown. Use for questions like how did the launch post do.

get-analytics-post

Get an overall performance summary across every workspace the user can access, with per-workspace breakdowns. Use for questions like how is my social media doing this month, or for executive recaps.

get-analytics-summary

Get aggregated analytics for one workspace (every account and post in it). Use after list-workspaces when the user asks about a specific brand or client.

get-analytics-workspace

Load one campaign by ID, including the metadata needed to update it or report on it.

get-campaign

Load a single comment thread by ID, including nested replies, so you can quote it accurately or moderate it.

get-comment

Get one media library folder by id (with its parent when loaded) if it belongs to a workspace the user can access.

get-folder

Get one label by its numeric ID.

get-label

Get one media library item by id (`workspace_id`, `folder_id`, `url`, type) so it can be attached to a post or comment.

get-media

Find a PostSyncer post from the native platform post id saved after publishing (e.g. a tweet or status id). Use when the user only has the id returned by the network.

get-post-by-platform-post-id

Find a PostSyncer post from its public link (e.g. https://twitter.com/user/status/123). Use when the user pastes a link to something they published through PostSyncer and wants its details, an edit, or its analytics.

get-post-by-url

Load one post by ID: copy, media, schedule, target accounts, publication state, and platform links. Use before editing, duplicating, or reporting on a post.

get-post

Hide a comment on the native social network (e.g. spam or abuse under an Instagram or Facebook post) while keeping the record in PostSyncer. Only works for comments linked to a published platform post.

hide-comment

List the social accounts connected to PostSyncer (Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Threads, Bluesky, Pinterest, Telegram, Mastodon) across the workspaces the user can access. Call this before creating a post to get account IDs, or when the user asks which accounts are connected. When the result is empty, give the user `connect_url` as a clickable link so they can connect their social accounts.

list-accounts

List campaigns with optional filters (workspace, status). Use to plan, audit, or report on grouped content.

list-campaigns

List comments on a specific post (`post_id` required) with pagination. Use to triage replies, find questions to answer, or build context before replying.

list-comments

List media library folders in workspaces the user can access. Optional `workspace_id`, `parent_id`, or `root` (top-level only).

list-folders

List labels in the workspaces the user can access, with optional filters. Labels tag posts and campaigns for organization and filtering.

list-labels

Browse the media library (images, videos, and documents already uploaded) with pagination. Filter by `workspace_id`, `folder_id`, or `root_only` (items not in a folder). Use when the user wants to reuse an existing image or video in a post. Default 50 per page, max 100.

list-media

List scheduled, published, draft, and failed posts with pagination (`per_page` 1-100, `page`). Use for questions like what is scheduled this week or show my recent posts. Set `include_comments` true to embed comment summaries on each post.

list-posts

List the PostSyncer workspaces (brands or clients) the user belongs to. Call this first to get workspace IDs for posts, media, labels, and campaigns.

list-workspaces

Fetch the latest comments from each connected network for a published post—like refreshing the unified inbox in the app. Use after publishing or when the thread looks out of date.

sync-comments-from-platforms

Ask PostSyncer to refresh stored analytics for a post’s published platform rows (runs asynchronously). Use when metrics look stale after recent activity.

sync-post-analytics

Edit an existing campaign (name, status, details). Fields mirror create-campaign.

update-campaign

Edit the text or attachments of a comment the user wrote (author only). Pass `media` as an empty array to remove attachments; each item is a library id or URL, like post `content[].media`.

update-comment

Rename a media folder, change its color, or move it under another parent. Provide at least one field; a folder cannot be moved into itself or a descendant.

update-folder

Rename or otherwise edit a label without recreating it.

update-label

Turn auto plug on or off for a post: PostSyncer automatically replies with a follow-up (e.g. a link) once likes, reposts, replies, or views reach a threshold. Set enabled=false to clear. Matches PATCH /api/v1/posts/{post}/auto-plug.

update-post-auto-plug

Set comment moderation for a post: keyword filters, hide rules, and AI auto-replies. When enabled=true, provide the full settings object per the API docs. Matches PATCH /api/v1/posts/{post}/comment-moderation.

update-post-comment-moderation

Add commenters to CRM lists: keyword_rules mode or add_all with list_id. Matches PATCH /api/v1/posts/{post}/contact-collection. List IDs must belong to the post workspace.

update-post-contact-collection

Edit an existing post: change the copy, media, target accounts, schedule time, or repeat settings. Same field shapes as create-post (content with optional cover_image and first-comment flags, repeatable_accounts with repeatable, etc.). Call get-post first if you need the current state. Permissions: posts:update; leaving the post scheduled needs posts:schedule and `publish_now` needs posts:publish (drafts need nothing extra).

update-post

Upload an image, video, or document from the conversation (base64) into the media library so it can be attached to a post or comment (same rules as POST /media/upload/file). Documents (PDF/DOC/DOCX/PPT/PPTX) publish to LinkedIn only. For large files prefer the REST API with multipart form data. Optional `folder_id`. Returns one `media` item with an id.

upload-media-file

Import one or more image/video/document URLs into a workspace media library (same rules as POST /media/upload/url; documents like PDF publish to LinkedIn only). Returns `media` items with ids for posts and comments. Optional `folder_id`.

upload-media-from-url