The author's pending publication schedule for a post

GET

/posts/{id}/publication-schedule

• Local development behind nginx (port 8088 by default)

The author-facing status read of scheduled publication (#1119, ADR 0020). Answers with the ONE pending schedule the author made for this post, or null when there is none.

Own-post only. The caller must be the post’s author; a readable post authored by somebody else is refused with 403, and a post the caller cannot read (including a soft-deleted one) is 404, in that order, so this cannot be used to learn which post ids exist. Operator- and system-scheduled actions on the same post are NOT reported here: this surface shows the author their own instruction and nothing else.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

The pending author schedule, or null.

object

schedule

required

object

id

required

string format: uuid

post_id

required

string format: uuid

scheduled_for

required

When the post becomes eligible to publish. It is carried out on the scheduler’s next normal pass after this time, not at this exact second.

string format: date-time

state

required

string

Allowed values: pending done cancelled failed

created_by

required

The author who scheduled it; always the requesting user.

integer format: int64

created_at

required

string format: date-time

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed

500

Unexpected server error

object

error

required

Human-readable error summary

string

Example

the request could not be completed