Schedule Blog Post

POST

/api/v1/posts/{id}/schedule

Authorizations

SessionAuth

Session ID for authenticated requests

Type

API Key (header: X-Session-ID)

Parameters

Path Parameters

id*

Type

string

Required

Request Body

application/json

{

  

"scheduled_at": "string"

}

Responses

Post scheduled

POST

/api/v1/posts/{id}/schedule

Playground

Server

Authorization

SessionAuth

Variables

Key

Value

id*

Body

Samples

Powered by VitePress OpenAPI

Schedule a blog post for later publishing.

Auth: session + owner/admin.

Parameters

Name	In	Type	Required	Description
id	path	string	Yes	Post id

Request Body

{
	"scheduled_at": "2026-04-05T10:00:00.000Z"
}

Response 200

{
	"data": { "id": "post_2", "status": "scheduled", "scheduled_at": "2026-04-05T10:00:00.000Z" },
	"user_context": { "authenticated": true },
	"meta": {}
}

Response Errors

• 400 invalid schedule payload
• 401 missing session
• 403 not owner/admin
• 404 post not found

Notes

• Use this for timed editorial publishing.
• The post remains hidden until the scheduled publish moment.