---
title: "Changes to Update a post by ID"
method: PUT
path: "/v1/posts/{postId}"
---

# Changes to Update a post by ID

`PUT /v1/posts/{postId}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 10 of 61 revisions.

- **2026-08-28** `8108f2a53d2e` — 3 info
- **2026-08-25** `a38cc07e90d8` — 1 info
- **2026-07-21** `644a3e39740b` — 1 info
- **2026-06-25** `17b3077bd119` — 1 info
- **2026-06-22** `9c830051404c` — 1 info
- **2026-05-08** `bd33b6b2bee8` — 2 info
- **2026-05-07** `90de04b87133` — 4 warning
- **2026-04-28** `79fe03bb4057` — 1 info
- **2026-04-14** `83a575869764` — 2 info
- **2026-03-20** `5b9472285686` — 1 info

## Changes

- **2026-08-28** `8108f2a53d2e` — 3 info
  - added the new optional request property `canonicalUrl`
  - added the new optional request property `communityId`
  - added the new optional request property `publishOnline`
- **2026-08-25** `a38cc07e90d8` — 1 info
  - added the new optional request property `imageAlt`
- **2026-07-21** `644a3e39740b` — 1 info
  - added the new optional request property `authorIds`
- **2026-06-25** `17b3077bd119` — 1 info
  - added the new optional request property `bodyJson`
- **2026-06-22** `9c830051404c` — 1 info
  - added the non-success response with the status `409`
- **2026-05-08** `bd33b6b2bee8` — 2 info
  - added the new optional request property `clearImage`
  - added the new optional request property `imageUrl`
- **2026-05-07** `90de04b87133` — 4 warning
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `401` status
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `error` from the response with the `500` status
- **2026-04-28** `79fe03bb4057` — 1 info
  - added the new optional request property `publishedAt`
- **2026-04-14** `83a575869764` — 2 info
  - added the new optional request property `scheduledAt`
  - added the new optional request property `sendNewsletter`
- **2026-03-20** `5b9472285686` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/docs/v1/posts/:postId/put.md) · [API](https://skmtc.dev/paragraph-xyz/apis/paragraph-api.md) · [Page](https://skmtc.dev/paragraph-xyz/apis/paragraph-api/changes/v1/posts/:postId/put)