---
title: "Changes to Create a trail discussion"
method: POST
path: "/api/v1/trails/{forge}/{owner}/{repo}/{number}/discussions"
---

# Changes to Create a trail discussion

`POST /api/v1/trails/{forge}/{owner}/{repo}/{number}/discussions`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 29 revisions.

- **2026-09-24** `ba1409f8f36b` — 1 breaking, 3 info
- **2026-09-23** `a7ac2797c1a0` — 2 breaking, 2 info

## Changes

- **2026-09-24** `ba1409f8f36b` — 1 breaking, 3 info
  - added `subschema #1, subschema #2` to the `discussion` response property `oneOf` list for the response status `201`
  - added the optional property `message/anyOf[subschema #1]/identity` to the response with the `201` status
  - added the optional property `message/anyOf[subschema #1]/replies/items/identity` to the response with the `201` status
  - removed `subschema #1, subschema #2` from the `discussion` response property `oneOf` list for the response status `201`
- **2026-09-23** `a7ac2797c1a0` — 2 breaking, 2 info
  - removed the required property `discussion/oneOf[subschema #2]/review_comment/thread_id` from the response with the `201` status
  - removed the required property `discussion/oneOf[subschema #2]/review_comment/thread_message_count` from the response with the `201` status
  - added the required property `discussion/oneOf[subschema #2]/review_comment/discussion_id` to the response with the `201` status
  - added the required property `discussion/oneOf[subschema #2]/review_comment/discussion_message_count` to the response with the `201` status

---

[Operation](https://skmtc.dev/entire/apis/entire-api/docs/api/v1/trails/:forge/:owner/:repo/:number/discussions/post.md) · [API](https://skmtc.dev/entire/apis/entire-api.md) · [Page](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/trails/:forge/:owner/:repo/:number/discussions/post)