Update post
Canonical update endpoint for draft edits, scheduled-post rescheduling, and lifecycle transitions such as archive, restore, and cancel.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Path Params
post_idstring
UniPost post ID.
Request Body
platform_postsOptionalarray
Draft-only content update. Replaces the stored per-account payload.
scheduled_atOptionalstring
Scheduled or quota-hold update. Reschedules the post when set to a future RFC3339 timestamp and rechecks monthly scheduling capacity.
archivedOptionalboolean
Canonical lifecycle patch. Set `true` to archive or `false` to restore.
statusOptional"canceled"
Canonical lifecycle patch for draft or scheduled posts. Cancels the post without dispatching more work.
Response Body
200
idstring
UniPost post ID.
statusstring
Updated lifecycle state.
archived_atstring | null
Archive timestamp when the post is archived.
scheduled_atstring | null
Updated scheduled publish time for scheduled posts.
quota_hold_reasonstring | null
Present when a downgrade preserved the post on quota hold instead of dispatching it.
quota_hold_atstring | null
Timestamp when the post entered quota hold.
request_idstring
Request identifier for debugging and support.
401
error.codestring
Usually "VALIDATION_ERROR", "CONFLICT", "NOT_FOUND", or "PLAN_MONTHLY_SCHEDULING_CAPACITY_EXCEEDED" (HTTP 402).
error.normalized_codestring
Lowercase alias such as "validation_error", "conflict", or "not_found".
error.messagestring
Human-readable error message.
error.detailsOptionalobject
Paid scheduling capacity snapshot and projected usage when the update would exceed 100%.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Usually "VALIDATION_ERROR", "CONFLICT", "NOT_FOUND", or "PLAN_MONTHLY_SCHEDULING_CAPACITY_EXCEEDED" (HTTP 402).
error.normalized_codestring
Lowercase alias such as "validation_error", "conflict", or "not_found".
error.messagestring
Human-readable error message.
error.detailsOptionalobject
Paid scheduling capacity snapshot and projected usage when the update would exceed 100%.
request_idstring
Request identifier for debugging and support.
409
error.codestring
Usually "VALIDATION_ERROR", "CONFLICT", "NOT_FOUND", or "PLAN_MONTHLY_SCHEDULING_CAPACITY_EXCEEDED" (HTTP 402).
error.normalized_codestring
Lowercase alias such as "validation_error", "conflict", or "not_found".
error.messagestring
Human-readable error message.
error.detailsOptionalobject
Paid scheduling capacity snapshot and projected usage when the update would exceed 100%.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Usually "VALIDATION_ERROR", "CONFLICT", "NOT_FOUND", or "PLAN_MONTHLY_SCHEDULING_CAPACITY_EXCEEDED" (HTTP 402).
error.normalized_codestring
Lowercase alias such as "validation_error", "conflict", or "not_found".
error.messagestring
Human-readable error message.
error.detailsOptionalobject
Paid scheduling capacity snapshot and projected usage when the update would exceed 100%.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "VALIDATION_ERROR", "CONFLICT", "NOT_FOUND", or "PLAN_MONTHLY_SCHEDULING_CAPACITY_EXCEEDED" (HTTP 402).
error.normalized_codestring
Lowercase alias such as "validation_error", "conflict", or "not_found".
error.messagestring
Human-readable error message.
error.detailsOptionalobject
Paid scheduling capacity snapshot and projected usage when the update would exceed 100%.
request_idstring
Request identifier for debugging and support.
Use PATCH for direct resource state changes. Legacy command routes such as POST /v1/posts/:post_id/archive, /restore, and /cancel still work during the migration window, but PATCH is now the canonical route.