Posts

Confirm an async post's current state

Ask an asynchronous publishing platform for the current state now. Useful after a post is accepted in processing state. A provider-confirmed post is promoted to published immediately; failed transitions and credit refunds remain in the background recovery path.

post/v1/posts/{id}/refresh

Request

  • Base URL: https://api.postlake.dev
  • URL: https://api.postlake.dev/v1/posts/{id}/refresh
  • Auth: bearerAuth (a scheme the document does not define)

Path parameters

idstring required

Response

Current post state

idstring required
sourceDraftIdstring

Immutable original draft ID. New approvals preserve this as id; legacy audited approvals may resolve an older ID to a different canonical id.

snapshotstring

Computed full-state approval fence returned by GET. Includes media, options and metadata.

state'draft' | 'awaiting_approval' | 'rejected' | 'queued' | 'scheduled' | 'processing' | 'partial' | 'published' | 'failed' required
createdAtstring date-time required
clientIdstring

Stable machine principal that created the post. Absent for human-created dashboard posts.

surface'dashboard' | 'api' | 'agent'

Where the post was created, independent of the principal identity.

scheduledAtstring date-time nullable required
timezonestring

IANA timezone the caller scheduled in, when they named one.

scheduledAtLocalstring

Wall-clock time in timezone, computed on read. Not stored.

textstring required
campaignstring
assetMetadataobject
mediastring[] required
warningsstring[]

Advisory notes from create or edit, for example PNG converted to JPEG for TikTok.

Changes

No recorded changes to this operation across all 1 revision of this API.