Cancel the author's pending publication schedule

DELETE

/posts/{id}/publication-schedule

• Local development behind nginx (port 8088 by default)

Withdraws the caller’s own pending publication schedule for this post before it fires. The post stays exactly as it is (a draft stays a draft). Cancelling needs authorship of the post and nothing else, so an author whose posts.publish was revoked after scheduling can still take their instruction back. It never touches an operator’s or the system’s scheduled action on the same post.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Responses

200

The schedule that was cancelled.

An author’s standing instruction to publish one post (#1119, ADR 0020). A narrow view of the scheduled_actions row the instruction lives in: the generic fields (verb, target kind, params) are fixed for this surface and are not repeated.

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

The post is not readable, or it has no pending author schedule.

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