---
title: "Publish a post immediately"
method: POST
path: "/posts/{id}/publish"
tags: ["Posts"]
---

# Publish a post immediately

`POST /posts/{id}/publish`

## Path parameters

- `id` string, required

## Response `200`

Post queued for publishing

- object
  - `data` object
    - `id` string
    - `status` string
    - `message` string

## Other responses

- `400` — Post cannot be published. Only draft or scheduled posts are publishable: an already published post returns `already_published`, a failed post returns `post_failed`, and any other status (`warning`, `posting`) returns `invalid_status` — use POST /posts/{id}/retry for failed or partially failed posts. Also returned for validation problems (e.g., missing media for Instagram/TikTok, missing board_id for Pinterest, or Pinterest carousel slides at mismatched aspect ratios — see `mismatched_slides` on the error object)
- `404` — Post not found

---

[API](https://skmtc.dev/omnisocials/apis/omnisocials-api.md) · [All operations](https://skmtc.dev/omnisocials/apis/omnisocials-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omnisocials/omnisocials-api/revisions/e53b89af0b98/schema)