---
title: "POST /posts/{postId}/schedule"
method: POST
path: "/posts/{postId}/schedule"
---

# POST /posts/{postId}/schedule

`POST /posts/{postId}/schedule`

## Request

- Base URL: `https://api.publinio.com/v1`
- URL: `https://api.publinio.com/v1/posts/{postId}/schedule`
- Auth: HTTP bearer

Schedule the expected revision at an explicit future time, only when the user requests scheduling. Mandatory team approval remains in force; inspect the returned approval state. Never publishes immediately. Reuse the idempotency key on retries. X automatically reserves the required workspace credits when scheduling succeeds. Insufficient credits leave the post unscheduled; drafts or pending approvals are not scheduled posts. Required scope: posts:schedule.

## Path parameters

- `postId` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `revision` integer, required
  - `scheduledAt` string, date-time, required

## Response `200`

Result; lists contain data and nextCursor. Posts report their actual status and approval_state.

- object
  - `id` string, uuid, required
  - `status` string, required
  - `revision` integer, required
  - `approval_state` string
  - `scheduled_at` string, date-time, nullable

## Other responses

- `400`: Structured error with error.code, error.message and requestId.
- `401`: Structured error with error.code, error.message and requestId.
- `403`: Structured error with error.code, error.message and requestId.
- `404`: Structured error with error.code, error.message and requestId.
- `409`: Structured error with error.code, error.message and requestId.
- `422`: Structured error with error.code, error.message and requestId.
- `429`: Structured error with error.code, error.message and requestId.
- `500`: Structured error with error.code, error.message and requestId.

---

[API](https://skmtc.dev/publinio/apis/publinio-developer-api.md) · [All operations](https://skmtc.dev/publinio/apis/publinio-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/publinio/apis/publinio-developer-api/revisions/2a193fb6939b?raw)