# Postbreeze

## Docs

- [Disconnect a channel](https://docs.postbreeze.ai/api-reference/channels/disconnect-a-channel.md): Disconnects a social account from Postbreeze.
- [Get a connected channel](https://docs.postbreeze.ai/api-reference/channels/get-a-connected-channel.md): Returns a single connected social account.
- [List connected channels](https://docs.postbreeze.ai/api-reference/channels/list-connected-channels.md): Returns the social accounts you've connected — Instagram pages, TikTok profiles, LinkedIn accounts, and so on.
- [Start an OAuth connect flow](https://docs.postbreeze.ai/api-reference/channels/start-an-oauth-connect-flow.md): Starts the process of connecting a social account (Instagram, TikTok, LinkedIn, etc.) to one of your workspaces.
- [List comments](https://docs.postbreeze.ai/api-reference/comments/list-comments.md): Returns comments from your inbox, newest first.
- [Mark a comment read or unread](https://docs.postbreeze.ai/api-reference/comments/mark-a-comment-read-or-unread.md): Flips a comment between read and unread.
- [Pull fresh comments from each platform](https://docs.postbreeze.ai/api-reference/comments/pull-fresh-comments-from-each-platform.md): Pulls new comments from the social platforms into your inbox.
- [Reply to a comment](https://docs.postbreeze.ai/api-reference/comments/reply-to-a-comment.md): Posts a reply to a comment on the original platform.
- [Get a connect session (candidates + metadata)](https://docs.postbreeze.ai/api-reference/connect-sessions/get-a-connect-session-candidates-+-metadata.md)
- [Import picked candidates as SocialAccount rows](https://docs.postbreeze.ai/api-reference/connect-sessions/import-picked-candidates-as-socialaccount-rows.md)
- [Start an OAuth connect flow](https://docs.postbreeze.ai/api-reference/connect/start-an-oauth-connect-flow.md): Returns `{ authUrl, state }`. Redirect your user to `authUrl`; Postbreeze handles OAuth + the picker UI and bounces them to `returnUrl?connected=1`. Returns 402 PLAN_LIMIT_ACCOUNTS if the workspace is at its account cap.
- [Get a media upload URL](https://docs.postbreeze.ai/api-reference/media/get-a-media-upload-url.md): Uploading an image or video is a three-step process. This is step one.
- [API reference](https://docs.postbreeze.ai/api-reference/overview.md): Full machine-readable spec is published as openapi.json — Mintlify renders the interactive playground below.
- [Cancel a scheduled post](https://docs.postbreeze.ai/api-reference/posts/cancel-a-scheduled-post.md): Stops a scheduled post from publishing. Postbreeze cancels the pending publish so the post doesn't go out, and marks both the post and every account on it as cancelled.
- [Create a post](https://docs.postbreeze.ai/api-reference/posts/create-a-post.md): Creates a new post — either a draft you'll schedule later or one that's already scheduled to go out at a specific time — and queues it up for every account you list.
- [Delete a post](https://docs.postbreeze.ai/api-reference/posts/delete-a-post.md): Deletes a post. The row stays in our database for audit purposes, but it's hidden from every listing and from `GET /posts/{postId}` — for your purposes it's gone.
- [Get a post](https://docs.postbreeze.ai/api-reference/posts/get-a-post.md): Returns a single post by id, with its per-account targets and attached media included in the response.
- [List posts](https://docs.postbreeze.ai/api-reference/posts/list-posts.md): Lists posts you can see, ordered by upcoming scheduled time first and then by most recently created.
- [Reschedule a scheduled post](https://docs.postbreeze.ai/api-reference/posts/reschedule-a-scheduled-post.md): Moves a scheduled post to a different time. Postbreeze cancels the pending publish and re-queues the post at the new time, so the new time is the one that sticks.
- [Retry a failed post](https://docs.postbreeze.ai/api-reference/posts/retry-a-failed-post.md): Has another go at publishing every account on the post that failed last time. Postbreeze re-queues those accounts to publish right away.
- [Retry first-comment for a published target](https://docs.postbreeze.ai/api-reference/posts/retry-first-comment-for-a-published-target.md): Has another go at posting the auto-first-comment for one account on the post. Use this when the main post landed fine but the follow-up first comment failed on its own — usually because of a rate limit, a missing permission, or because comments were turned off on the post at the moment we tried.
- [Schedule a draft post](https://docs.postbreeze.ai/api-reference/posts/schedule-a-draft-post.md): Takes a draft and queues it up to publish at the time you pass in. Postbreeze handles the rest — when the time comes around, it fans the post out to every account on the post and tries to publish each one.
- [Update a post](https://docs.postbreeze.ai/api-reference/posts/update-a-post.md): Edits an existing post. Works on drafts, scheduled posts, and posts that previously failed or were cancelled — basically anything that hasn't been published yet. Posts that are currently publishing, already published, or partially published can't be edited and will return a `400`.
- [Create workspace](https://docs.postbreeze.ai/api-reference/workspaces/create-workspace.md): Creates a new workspace and makes you the owner.
- [Delete workspace](https://docs.postbreeze.ai/api-reference/workspaces/delete-workspace.md): Permanently deletes a workspace and everything inside it.
- [Get workspace](https://docs.postbreeze.ai/api-reference/workspaces/get-workspace.md): Returns a single workspace.
- [Leave workspace](https://docs.postbreeze.ai/api-reference/workspaces/leave-workspace.md): Removes you from a workspace.
- [List workspaces](https://docs.postbreeze.ai/api-reference/workspaces/list-workspaces.md): Returns every workspace you're a member of, oldest first.
- [Update workspace](https://docs.postbreeze.ai/api-reference/workspaces/update-workspace.md): Updates a workspace's display name, timezone, time format, brand color, or logo.
- [Error Handling](https://docs.postbreeze.ai/concepts/errors.md): Predictable failure modes for the Postbreeze REST API.
- [Media uploads](https://docs.postbreeze.ai/concepts/media-uploads.md): Upload images and videos to attach to your scheduled posts.
- [Platform settings](https://docs.postbreeze.ai/concepts/platform-settings.md): Per-platform options that go beyond a caption and a few images.
- [Rate limits](https://docs.postbreeze.ai/concepts/rate-limits.md): Per-key throughput ceilings.
- [Webhooks](https://docs.postbreeze.ai/concepts/webhooks.md): Receive real-time events when posts publish, accounts disconnect, comments arrive, and more.
- [Install in Claude / Cursor](https://docs.postbreeze.ai/mcp/install.md): Add the Postbreeze MCP server to your AI client in one paste.
- [MCP security model](https://docs.postbreeze.ai/mcp/security.md): What an MCP-connected LLM can and cannot do with your Postbreeze workspace.
- [Tools](https://docs.postbreeze.ai/mcp/tools.md): The v1 MCP tool surface — what Claude / Cursor can do on your behalf.
- [Facebook](https://docs.postbreeze.ai/platforms/facebook.md): Schedule Facebook posts — Feed, Photo, Photo Carousel, Video, and Reels. Page accounts only.
- [Instagram](https://docs.postbreeze.ai/platforms/instagram.md): Schedule Instagram Feed posts, Reels, and carousels via Postbreeze. Business and Creator accounts only.
- [LinkedIn](https://docs.postbreeze.ai/platforms/linkedin.md): Schedule LinkedIn Personal and Company posts — single image, multi-image gallery, video, and PDF carousel.
- [Platforms](https://docs.postbreeze.ai/platforms/overview.md): Per-platform integration guides — content types, fields, media constraints, and analytics for every supported network.
- [Pinterest](https://docs.postbreeze.ai/platforms/pinterest.md): Schedule Pinterest pins — single image, carousel pin, with board selection, titles, and outbound links.
- [Threads](https://docs.postbreeze.ai/platforms/threads.md): Schedule Threads posts — text, image, video, carousel (up to 20 mixed items), plus multi-post threads.
- [TikTok](https://docs.postbreeze.ai/platforms/tiktok.md): Schedule and publish TikTok videos and photo carousels — privacy settings, branded content, and disclosures.
- [X (Twitter)](https://docs.postbreeze.ai/platforms/x.md): Schedule tweets, threads, and replies — with media, reply settings, and Pay-Per-Use billing notes.
- [YouTube](https://docs.postbreeze.ai/platforms/youtube.md): Schedule YouTube video uploads — Shorts, long-form, COPPA flags, and first-comment via the Community surface.
- [Quickstart](https://docs.postbreeze.ai/quickstart.md): Schedule your first post in under five minutes.

## OpenAPI Specs

- [openapi](https://docs.postbreeze.ai/openapi.json)
- [openapi-workspaces](https://docs.postbreeze.ai/openapi-workspaces.json)
- [openapi-posts](https://docs.postbreeze.ai/openapi-posts.json)
- [openapi-media](https://docs.postbreeze.ai/openapi-media.json)
- [openapi-connect](https://docs.postbreeze.ai/openapi-connect.json)
- [openapi-connect-sessions](https://docs.postbreeze.ai/openapi-connect-sessions.json)
- [openapi-comments](https://docs.postbreeze.ai/openapi-comments.json)
- [openapi-channels](https://docs.postbreeze.ai/openapi-channels.json)