UniPost
Dashboard

Get post

Returns one social post with per-account results, diagnostics, and resolved destination metadata.
https://api.unipost.dev
GET/v1/posts/:post_id
Authorization
In header · Bearer <token>
Path
string

Authorization

AuthorizationBearer <token>In header
Workspace API key.

Path Params

post_idstring
UniPost post ID such as post_abc123.

Response Body

200
idstring
UniPost post ID.
captionstring | null
Top-level caption when one exists.
statusstring
Derived lifecycle status. For multi-platform posts, this is the aggregate parent status.
Valuesdraft | scheduled | publishing | published | partial | failed | cancelled
sourcestring
Origin of the post.
Valuesapi | ui
profile_idsstring[]
Distinct profile IDs targeted by the post.
resultsarray
Per-account publish results.
results[].idstring
Result row ID used for retries and diagnostics.
results[].social_account_idstring
Destination account ID.
results[].platformstring
Destination platform.
Valuestwitter | linkedin | instagram | facebook | threads | youtube | tiktok | bluesky | pinterest
results[].account_namestring
Resolved handle or account display name when available.
results[].statusstring
Per-account publish status.
Valuesqueued | publishing | processing | published | failed
results[].urlstring | null
Canonical public post URL when available.
results[].debug_curlstring | null
Redacted failing curl trace for debugging, only on failed results.
401
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
404
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Usually "UNAUTHORIZED" or "NOT_FOUND".
error.normalized_codestring
Lowercase alias such as "unauthorized" or "not_found".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
How to use this endpoint from a client
Use the parent status for the big picture. This is the fastest way to know whether the post is done, partially successful, or fully failed.
Use results[] for the truth per destination. Each result row is independent and tells you which account published, which one failed, and which public URL or error belongs to that account.
Stop polling when the parent status is final. In most clients that means polling until the post becomes published, partial, or failed.
Polling examples users can compare against
Rule of thumb
Single-platform posts: the parent post status usually matches the only result row.
Multi-platform posts: read the parent post status as the aggregate outcome, then read results[] to know what happened on each destination account.