---
title: "Trigger publish"
method: POST
path: "/posts/{id}/publish"
tags: ["Posts"]
---

# Trigger publish

`POST /posts/{id}/publish`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/posts/{id}/publish`
- Auth: API key in header `X-Api-Key`

Forces the publishing pipeline to run for a post that is currently `pending`, `failed`, or stuck. Useful for scheduled posts you want to publish early, or to nudge a post whose worker missed its window.

## Path parameters

- `id` string, required

## Response `200`

Response for status 200

- object
  - `id` string, required
  - `processed` boolean, required
  - `successful_items` number, required
  - `failed_items` number, required

## Other responses

- `400`: Response for status 400
- `404`: Response for status 404

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)