---
title: "Changes to Create a message"
method: POST
path: "/v1/messages"
---

# Changes to Create a message

`POST /v1/messages`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 3 revisions.

- **2026-11-03** `b697d49fa1f9`: 46 breaking, 25 warning, 35 info

## Changes

- **2026-11-03** `b697d49fa1f9`: 46 breaking, 25 warning, 35 info
  - added `#/components/schemas/MessageParamContent` to the `messages/items/content` request property `allOf` list
  - added `#/components/schemas/MessageRole` to the `messages/items/role` request property `allOf` list
  - removed `#/components/schemas/OutputConfigParam, subschema #2` from the `output_config` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `messages/items/content` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `thinking` request property `anyOf` list
  - removed `subschema #1, subschema #2` from the `tool_choice` request property `anyOf` list
  - removed `subschema #1, subschema #2, subschema #3` from the `system` request property `anyOf` list
  - removed the enum value `assistant` of the request property `messages/items/role`
  - removed the enum value `user` of the request property `messages/items/role`
  - request property `stop_sequences` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `temperature` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `tools` list-of-types was narrowed by removing types `null` from media type `application/json`
  - request property `top_p` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `max_tokens` request property format changed from no format to `int64`
  - the `messages/items/role` request property type changed from `string` to no type
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` to the response body `oneOf` list for the response status `200` (media type: text/event-stream)
  - the response's body type changed from `object` to no type for status `200` (media type: application/json)
  - the `error` response's property type changed from `object` to no type for status `400`
  - the `error` response's property type changed from `object` to no type for status `401`
  - the `error` response's property type changed from `object` to no type for status `402`
  - the `error` response's property type changed from `object` to no type for status `403`
  - the `error` response's property type changed from `object` to no type for status `410`
  - the `error` response's property type changed from `object` to no type for status `429`
  - the `error` response's property type changed from `object` to no type for status `500`
  - the `error` response's property type changed from `object` to no type for status `503`
  - removed the required property `content` from the response with the `200` status (media type: application/json)
  - removed the required property `created` from the response with the `200` status (media type: application/json)
  - removed the required property `detail` from the response with the `422` status
  - removed the required property `error/message` from the response with the `400` status
  - removed the required property `error/message` from the response with the `401` status
  - removed the required property `error/message` from the response with the `402` status
  - removed the required property `error/message` from the response with the `403` status
  - removed the required property `error/message` from the response with the `410` status
  - removed the required property `error/message` from the response with the `429` status
  - removed the required property `error/message` from the response with the `500` status
  - removed the required property `error/message` from the response with the `503` status
  - removed the required property `error/type` from the response with the `400` status
  - removed the required property `error/type` from the response with the `401` status
  - removed the required property `error/type` from the response with the `402` status
  - removed the required property `error/type` from the response with the `403` status
  - …66 more

---

[Operation](https://skmtc.dev/naga/apis/nagaai-api/docs/v1/messages/post.md) - [API](https://skmtc.dev/naga/apis/nagaai-api.md) - [Page](https://skmtc.dev/naga/apis/nagaai-api/changes/v1/messages/post)