---
title: "Changes to Create a new post"
method: POST
path: "/v1/posts"
---

# Changes to Create a new post

`POST /v1/posts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 8 of 61 revisions.

- **2026-08-25** `a38cc07e90d8` — 1 info
- **2026-07-21** `644a3e39740b` — 1 info
- **2026-06-25** `17b3077bd119` — 2 info
- **2026-05-07** `90de04b87133` — 4 warning
- **2026-04-14** `83a575869764` — 2 info
- **2026-03-20** `5b9472285686` — 1 info
- **2026-01-13** `6b1ebbf54a87` — 2 info
- **2025-12-16** `44ce6b0df8f8` — 1 info

## Changes

- **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` — 2 info
  - added the new optional request property `bodyJson`
  - the request property `markdown` became optional
- **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-14** `83a575869764` — 2 info
  - added the new optional request property `scheduledAt`
  - added the required property `status` to the response with the `200` status
- **2026-03-20** `5b9472285686` — 1 info
  - added the new optional request property `status`
- **2026-01-13** `6b1ebbf54a87` — 2 info
  - request property `categories` list-of-types was widened by adding types `string` to media type `application/json`
  - request property `sendNewsletter` list-of-types was widened by adding types `string` to media type `application/json`
- **2025-12-16** `44ce6b0df8f8` — 1 info
  - endpoint added

---

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