# PostSyncer API Documentation

> REST API for posts, media (list, get, delete, file + URL upload), media folders (CRUD), comments (CRUD + hide), analytics, workspaces, accounts, and labels. Guides for authentication, errors, and rate limits.

## Docs

- [Delete Account](https://docs.postsyncer.com/api-reference/accounts/delete.md): Delete a social media account from your workspace
- [List Accounts](https://docs.postsyncer.com/api-reference/accounts/list.md): Retrieve all social media accounts from your workspaces
- [Analytics — by account](https://docs.postsyncer.com/api-reference/analytics/account.md): Cumulative metrics for one social account, plus each platform post row
- [Analytics — all workspaces](https://docs.postsyncer.com/api-reference/analytics/all-workspaces.md): Cumulative metrics across all accessible workspaces, with per-workspace breakdown
- [Analytics overview](https://docs.postsyncer.com/api-reference/analytics/overview.md): Engagement metrics across workspaces, a single workspace, a post, or an account
- [Analytics — by post](https://docs.postsyncer.com/api-reference/analytics/post.md): Aggregated analytics for one post across all accounts, plus per-account metrics
- [Analytics — queue sync for post](https://docs.postsyncer.com/api-reference/analytics/sync-post.md): Queue background jobs to refresh analytics for a post’s published platform rows
- [Analytics — by workspace](https://docs.postsyncer.com/api-reference/analytics/workspace.md): Cumulative metrics for all posts in one workspace
- [Create comment](https://docs.postsyncer.com/api-reference/comments/create.md): Create a comment or reply on a post
- [Delete comment](https://docs.postsyncer.com/api-reference/comments/delete.md): Delete a comment and sync removal to the network when applicable
- [Get comment](https://docs.postsyncer.com/api-reference/comments/get.md): Retrieve a single comment with nested replies
- [Hide comment on platform](https://docs.postsyncer.com/api-reference/comments/hide.md): Hide a social reply via the platform API
- [List comments](https://docs.postsyncer.com/api-reference/comments/list.md): Paginated comments for a post, with optional nested replies and filters
- [Comments overview](https://docs.postsyncer.com/api-reference/comments/overview.md): Manage post comments and replies via API v1
- [Sync comments from platforms](https://docs.postsyncer.com/api-reference/comments/sync.md): Pull social comments from networks for a post’s published platform rows
- [Update comment](https://docs.postsyncer.com/api-reference/comments/update.md): Update your own comment text and/or media
- [Create folder](https://docs.postsyncer.com/api-reference/folders/create.md): Create a media library folder (optional parent, color)
- [Delete folder](https://docs.postsyncer.com/api-reference/folders/delete.md): Delete a media library folder
- [Get folder](https://docs.postsyncer.com/api-reference/folders/get.md): Retrieve one media folder by id
- [List folders](https://docs.postsyncer.com/api-reference/folders/list.md): List media library folders for your workspaces (optional filters)
- [Update folder](https://docs.postsyncer.com/api-reference/folders/update.md): Update folder name, color, and/or parent
- [API reference overview](https://docs.postsyncer.com/api-reference/introduction.md): What the PostSyncer REST API includes—platforms, versioning, and links to endpoint docs
- [Create Label](https://docs.postsyncer.com/api-reference/labels/create.md): Create a new label to categorize your social media posts
- [Delete Label](https://docs.postsyncer.com/api-reference/labels/delete.md): Delete a label from your workspace
- [Get Label](https://docs.postsyncer.com/api-reference/labels/get.md): Retrieve a specific label by ID
- [List Labels](https://docs.postsyncer.com/api-reference/labels/list.md): Retrieve all labels from your workspaces
- [Update Label](https://docs.postsyncer.com/api-reference/labels/update.md): Update an existing label with new information
- [Delete media](https://docs.postsyncer.com/api-reference/media/delete.md): Remove a media library item and its stored file
- [Get media](https://docs.postsyncer.com/api-reference/media/get.md): Retrieve one media library item by id
- [List media](https://docs.postsyncer.com/api-reference/media/list.md): Paginated media library items across workspaces you can access
- [Media overview](https://docs.postsyncer.com/api-reference/media/overview.md): List, get, delete, upload files, or import URLs into your workspace library, then attach media by id or URL when creating posts
- [Upload media from file](https://docs.postsyncer.com/api-reference/media/upload-file.md): Single multipart request: send the file plus workspace_id (optional folder_id). MIME type is detected from the file.
- [Import media from URL](https://docs.postsyncer.com/api-reference/media/upload-url.md): Store remote images/videos into the workspace library from JSON — direct URLs, social links, Unsplash, etc.
- [Update post auto plug](https://docs.postsyncer.com/api-reference/posts/auto-plug.md): Enable or disable automatic replies when engagement thresholds (likes, reposts, replies, views) are met.
- [Update post comment moderation](https://docs.postsyncer.com/api-reference/posts/comment-moderation.md): Per-post comment moderation (filters, keywords, optional AI reply) aligned with the dashboard.
- [Update post contact collection](https://docs.postsyncer.com/api-reference/posts/contact-collection.md): Add commenters to CRM lists via keyword rules or add-all mode.
- [Create Post](https://docs.postsyncer.com/api-reference/posts/create.md): Create a new social media post with content, media, and scheduling options
- [Delete Post](https://docs.postsyncer.com/api-reference/posts/delete.md): Delete a post and cancel any scheduled publishing
- [Get Post](https://docs.postsyncer.com/api-reference/posts/get.md): Retrieve a specific post by ID
- [List Posts](https://docs.postsyncer.com/api-reference/posts/list.md): Retrieve a paginated list of posts from your workspaces
- [Update Post](https://docs.postsyncer.com/api-reference/posts/update.md): Update an existing post with new content, scheduling, or settings. Only posts that have not been published yet can be updated.
- [List Workspaces](https://docs.postsyncer.com/api-reference/workspaces/list.md): Retrieve all workspaces that the authenticated user has access to
- [Authentication](https://docs.postsyncer.com/essentials/authentication.md): Learn how to authenticate your API requests with PostSyncer
- [Error Handling](https://docs.postsyncer.com/essentials/error-handling.md): Learn how to handle API errors and responses properly
- [PostSyncer API Documentation](https://docs.postsyncer.com/introduction.md): Complete API reference for PostSyncer - automate social media posting across many networks (X, Mastodon, LinkedIn, and more) with our REST API
- [Integrating MCP clients](https://docs.postsyncer.com/mcp/integrating-clients.md): Configure Claude Desktop, Claude Code, Cursor, and other MCP clients to use PostSyncer over Streamable HTTP with a Bearer token.
- [MCP overview](https://docs.postsyncer.com/mcp/overview.md): PostSyncer Model Context Protocol server — same powers as API v1 for AI assistants and autonomous agents.
- [MCP tools reference](https://docs.postsyncer.com/mcp/tools-reference.md): All PostSyncer MCP tool names: workspaces, accounts, labels, campaigns, posts, media, folders, comments, analytics.
- [Quick Start with PostSyncer API](https://docs.postsyncer.com/quickstart.md): Get up and running with the PostSyncer API in minutes
- [Fair Usage & API Limits](https://docs.postsyncer.com/rate-limits.md): Understand PostSyncer API rate limits

## OpenAPI Specs

- [openapi](https://docs.postsyncer.com/api-reference/openapi.json)