# PostOnce API

> Automate social publishing, scheduling, and cross-post workflows with the PostOnce Public API.

## Docs

- [Cancel post](https://docs.postonce.to/api-reference/cancel-post.md): Cancels a scheduled post without deleting the aggregate record.
- [Connect account](https://docs.postonce.to/api-reference/connect-account.md): Returns a hosted dashboard URL that starts the OAuth flow for the requested platform.
- [Create a workflow](https://docs.postonce.to/api-reference/create-a-workflow.md): Creates a future-content cross-post workflow from one source account to one or more target accounts. Use `settings.content_filters` to limit which future posts are eligible.
- [Create post](https://docs.postonce.to/api-reference/create-post.md): Creates one logical post that can target multiple connected accounts. Include `publish_at` to schedule it instead of sending immediately.
- [Create upload URL](https://docs.postonce.to/api-reference/create-upload-url.md): Creates a signed upload URL in the `social-media` storage bucket and returns a `media_id` you can use later when creating posts. Upload the raw file bytes to `data.upload.signedUrl` with `PUT`; do not open that URL in a browser.
- [Delete a workflow](https://docs.postonce.to/api-reference/delete-a-workflow.md): Deletes a workflow and any queued workflow items linked to it.
- [Delete post](https://docs.postonce.to/api-reference/delete-post.md): Cancels a scheduled post. This is functionally equivalent to the cancel endpoint.
- [Disconnect account](https://docs.postonce.to/api-reference/disconnect-account.md): Disconnects and deletes a connected account owned by the API key profile.
- [Get media](https://docs.postonce.to/api-reference/get-media.md): Resolves a previously returned `media_id` into its storage path and public URL.
- [Get post](https://docs.postonce.to/api-reference/get-post.md): Returns one aggregate post with per-target delivery state.
- [Get workflow](https://docs.postonce.to/api-reference/get-workflow.md): Returns one workflow by ID.
- [List accounts](https://docs.postonce.to/api-reference/list-accounts.md): Returns all social accounts owned by the API key profile, including disconnected accounts.
- [List posts](https://docs.postonce.to/api-reference/list-posts.md): Lists aggregate public posts for the authenticated profile.
- [List workflows](https://docs.postonce.to/api-reference/list-workflows.md): Lists all workflows owned by the authenticated profile.
- [Publish now](https://docs.postonce.to/api-reference/publish-now.md): Starts publishing a scheduled post immediately and returns the aggregate in processing state.
- [Update a workflow](https://docs.postonce.to/api-reference/update-a-workflow.md): Updates a future-content workflow configuration, including activation state, target accounts, and optional `settings.content_filters`.
- [Update post](https://docs.postonce.to/api-reference/update-post.md): Updates a scheduled post before it runs.
- [v1 changelog](https://docs.postonce.to/changelog/v1.md): Release notes for the PostOnce Public API v1.
- [Authentication](https://docs.postonce.to/getting-started/authentication.md): Authenticate requests to the PostOnce Public API with dashboard-generated API keys.
- [Data structures](https://docs.postonce.to/getting-started/data-structures.md): Learn the main objects returned by the PostOnce Public API.
- [Errors](https://docs.postonce.to/getting-started/errors.md): Understand the PostOnce Public API response envelope and common error codes.
- [Rate limits](https://docs.postonce.to/getting-started/rate-limits.md): Understand plan-based request limits and product limits in the PostOnce Public API.
- [Response format](https://docs.postonce.to/getting-started/response-format.md): Understand the standard success and error envelopes used by the PostOnce Public API.
- [Create a workflow](https://docs.postonce.to/guides/create-a-workflow.md): Create a cross-post workflow with the PostOnce Public API.
- [Create your first post](https://docs.postonce.to/guides/create-your-first-post.md): Publish one logical post to multiple connected accounts with the PostOnce Public API.
- [Schedule a post](https://docs.postonce.to/guides/schedule-a-post.md): Schedule a future post with the PostOnce Public API.
- [Introduction](https://docs.postonce.to/introduction.md): Get started with the PostOnce Public API.
- [PostOnce MCP](https://docs.postonce.to/mcp/docs.md): Connect PostOnce to Claude, Codex, and other MCP clients to create posts, upload media, and manage workflows with your PostOnce API key.

## OpenAPI Specs

- [public-api](https://docs.postonce.to/openapi/public-api.yaml)
- [openapi](https://docs.postonce.to/api-reference/openapi.json)