> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postsyncer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Post history

> Who changed a post, what they changed and when, newest first

## 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

**post** `integer` *required*

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

### Query

**before** `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

**id** `integer`

Unique; newest first.

**kind** `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`.

**at** `string`

When it happened (ISO 8601, UTC). For a run, its newest change.

**since** `string | null`

A run's oldest change; `null` for a single change.

**count** `integer`

How many changes the entry holds.

**by** `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.

**via** `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.

**fields** `string[]`

For `edited`: what changed. `text`, `media`, `content`, `title`, `notes`, `settings`, `campaign`, `repeat`, `auto_plug`, `comment_moderation`, `contact_collection` or `approval`.

**accounts** `object[]`

The accounts it was about (`id`, `platform`, `name`, `username`). For `accounts`, the ones added.

**removed\_accounts** `object[]`

For `accounts`, the ones taken off.

**labels** `object[]`

For `labels`, the ones added (`id`, `name`, `color`; `name` is `null` once the label is deleted).

**removed\_labels** `object[]`

For `labels`, the ones taken off.

**status** `string | null`

The post's status after it, for `created` and status changes.

**scheduled\_at** `string | null`

The post's time after it (ISO 8601, UTC).

**error** `string | null`

For `failed`: the reason for the last try, the same words as `error_message` in [Get post](https://docs.postsyncer.com/api-reference/posts/get.md): the network's message without the JSON it came in.

**url** `string | null`

For `posted`: the post on the network.

```bash theme={null}
curl -X GET "https://postsyncer.com/api/v1/posts/123/history" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

```json theme={null}
{
  "data": [
    {
      "id": 90412,
      "kind": "posted",
      "at": "2026-11-20T09:00:04Z",
      "since": null,
      "count": 1,
      "by": null,
      "via": null,
      "fields": [],
      "accounts": [{ "id": 55, "platform": "bluesky", "name": "Alder & Ash", "username": "alder.bsky.social" }],
      "removed_accounts": [],
      "labels": [],
      "removed_labels": [],
      "status": null,
      "scheduled_at": null,
      "error": null,
      "url": "https://bsky.app/profile/alder.bsky.social/post/3lb2x"
    },
    {
      "id": 90377,
      "kind": "edited",
      "at": "2026-11-19T16:42:10Z",
      "since": "2026-11-19T16:38:51Z",
      "count": 6,
      "by": { "kind": "team", "key": "user:12", "name": "Sara Bekele", "logo": null, "avatar": null, "user_id": 12 },
      "via": null,
      "fields": ["text", "media"],
      "accounts": [],
      "removed_accounts": [],
      "labels": [],
      "removed_labels": [],
      "status": null,
      "scheduled_at": null,
      "error": null,
      "url": null
    },
    {
      "id": 90310,
      "kind": "created",
      "at": "2026-11-19T16:30:02Z",
      "since": null,
      "count": 1,
      "by": { "kind": "agent", "key": "client:claude", "name": "Claude", "logo": "claude", "avatar": null, "user_id": null },
      "via": null,
      "fields": [],
      "accounts": [],
      "removed_accounts": [],
      "labels": [],
      "removed_labels": [],
      "status": "SCHEDULED",
      "scheduled_at": "2026-11-20T09:00:00Z",
      "error": null,
      "url": null
    }
  ],
  "next": null
}
```

### 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.