Skip to main content
GET

Post history

What happened to one post, newest first: who made it, edited it, scheduled, moved or published it, which accounts and labels were added or removed, and what each network did with it. It is the same history the post’s Details panel shows in PostSyncer.
  • One person’s run of the same change is one entry: a stretch of saves to the text is one edited entry with count saves, from since to at.
  • by is who did it: a team member, an agent or API key (Claude, ChatGPT, a key’s name), or PostSyncer AI. It is null for what PostSyncer or a network did on its own, such as a network posting it or an account being disconnected.
  • What PostSyncer does on its own while sending a post is left out; each network’s result (posted with its link, failed with the reason) is kept.
Requires the posts:read permission.

Path

integer
required
Post id (must belong to a workspace you can access).

Query

integer
The next of the page before. Leave it out for the newest entries.

Paging

20 entries a page. next is the value to send as before for older entries; it is null on the last page.

Entry

integer
Unique; newest first.
string
created, edited, scheduled, rescheduled, unscheduled, sent_for_approval, approved, published, retried, status, deleted, accounts, disconnected, posted, failed, deleted_on_platform, first_comment_sent, auto_plug_sent or labels.
string
When it happened (ISO 8601, UTC). For a run, its newest change.
string | null
A run’s oldest change; null for a single change.
integer
How many changes the entry holds.
object | null
Who did it: kind (team, agent, api_key, ai, blog, import, platform or earlier_api), key, name, logo, avatar and user_id (for a team member). On created it is who made the post, as the calendar shows it.
string | null
How a person acted outside the post editor: chat (a button on a Chat card), undo_link (the put-back link in an alert email) or reconnect (put back after the account was reconnected). null otherwise.
string[]
For edited: what changed. text, media, content, title, notes, settings, campaign, repeat, auto_plug, comment_moderation, contact_collection or approval.
object[]
The accounts it was about (id, platform, name, username). For accounts, the ones added.
object[]
For accounts, the ones taken off.
object[]
For labels, the ones added (id, name, color; name is null once the label is deleted).
object[]
For labels, the ones taken off.
string | null
The post’s status after it, for created and status changes.
string | null
The post’s time after it (ISO 8601, UTC).
string | null
For failed: the reason for the last try, the same words as error_message in Get post: the network’s message without the JSON it came in.
string | null
For posted: the post on the network.

Errors

401 · 403 (key lacks posts:read) · 404 (post not found or not accessible) · 422 (before is not a positive integer) The MCP tool get-post-history returns the same entries.