--- title: "Changes to Create Chat Session" method: POST path: "/v0/chat_sessions/chat_results" --- # Changes to Create Chat Session `POST /v0/chat_sessions/chat_results` > Every recorded change to this endpoint, newest first. ## Timeline Changed in 15 of 20 revisions. - **2024-04-25** `18384b1ef7b1` — 1 info - **2024-03-14** `4039a787399c` — 5 breaking, 9 info - **2024-03-04** `0df6a1bc1818` — 5 breaking, 3 warning, 4 info - **2024-02-19** `526411b78bcb` — 2 info - **2024-02-18** `827f7fcea5ec` — 2 breaking, 2 warning, 2 info - **2024-02-12** `8426217f13b8` — 3 info - **2024-02-06** `ad90c174da91` — 9 breaking, 4 info - **2024-02-06** `46e1f971a1e4` — 1 breaking, 2 info - **2024-02-06** `771f1cbc5bbe` — 1 breaking - **2024-02-06** `d6c01b5ee485` — 1 breaking, 1 info - **2024-02-06** `93b77d3628e9` — 1 breaking, 2 info - **2024-02-06** `e910bce29ade` — 3 breaking, 2 info - **2024-02-06** `3dc3f630bb31` — 1 breaking, 2 info - **2024-02-06** `757e4f199cf3` — 1 breaking, 2 info - **2024-02-06** `17c344f7ac45` — 13 breaking, 2 warning, 14 info ## Changes - **2024-04-25** `18384b1ef7b1` — 1 info - added the new optional request property `chat_session/tags` - **2024-03-14** `4039a787399c` — 5 breaking, 9 info - the `role` request property const value `assistant` was added - the `role` request property const value `user` was added - removed the enum value `assistant` of the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/role` - removed the enum value `user` of the request property `chat_session/messages/items/oneOf[subschema #1: User Message]/role` - added `subschema #1, subschema #2, subschema #3, subschema #4` to the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` response property `oneOf` list for the response status `200` (media type: text/event-stream) - the `event` response property const value `message_chunk` was added for the status `200` (media type: text/event-stream) - the `event` response property const value `records_cited` was added for the status `200` (media type: text/event-stream) - the `role` response property const value `assistant` was added for the status `200` (media type: application/json) - removed the `assistant` enum value from the `message/role` response property for the response status `200` (media type: application/json) - removed the `content_filter` enum value from the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` response property for the response status `200` (media type: text/event-stream) - removed the `length` enum value from the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` response property for the response status `200` (media type: text/event-stream) - removed the `message_chunk` enum value from the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/event` response property for the response status `200` (media type: text/event-stream) - removed the `records_cited` enum value from the `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/event` response property for the response status `200` (media type: text/event-stream) - removed the `stop` enum value from the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` response property for the response status `200` (media type: text/event-stream) - **2024-03-04** `0df6a1bc1818` — 5 breaking, 3 warning, 4 info - request property `chat_session/messages/items/oneOf[subschema #1: User Message]/role` was restricted to a list of enum values - request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/role` was restricted to a list of enum values - the `event` response property const value `message_chunk` was removed for the status `200` (media type: text/event-stream) - the `event` response property const value `records_cited` was removed for the status `200` (media type: text/event-stream) - the `role` response property const value `assistant` was removed for the status `200` (media type: application/json) - added the new `assistant` enum value to the `message/role` response property for the response status `200` (media type: application/json) - added the new `message_chunk` enum value to the `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/event` response property for the response status `200` (media type: text/event-stream) - added the new `records_cited` enum value to the `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/event` response property for the response status `200` (media type: text/event-stream) - the `role` request property const value `assistant` was removed - the `role` request property const value `user` was removed - added the new `assistant` enum value to the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/role` - added the new `user` enum value to the request property `chat_session/messages/items/oneOf[subschema #1: User Message]/role` - **2024-02-19** `526411b78bcb` — 2 info - added the new optional request property `chat_session/context` - added the new optional request property `chat_session/guidance` - **2024-02-18** `827f7fcea5ec` — 2 breaking, 2 warning, 2 info - the response property `message/records_cited/citations/items/number` became optional for the status `200` (media type: application/json) - the response property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/number` became optional for the status `200` (media type: text/event-stream) - added the new `custom_question_answer` enum value to the `message/records_cited/citations/items/record/type/oneOf[subschema #1: RecordTypeEnumerated]/` response property for the response status `200` (media type: application/json) - added the new `custom_question_answer` enum value to the `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/record/type/oneOf[subschema #1: RecordTypeEnumerated]/` response property for the response status `200` (media type: text/event-stream) - the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/number` became optional - added the new `custom_question_answer` enum value to the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/record/type/oneOf[subschema #1: RecordTypeEnumerated]/` - **2024-02-12** `8426217f13b8` — 3 info - added the new optional request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/record/description` - added the optional property `message/records_cited/citations/items/record/description` to the response with the `200` status (media type: application/json) - added the optional property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/record/description` to the response with the `200` status (media type: text/event-stream) - **2024-02-06** `ad90c174da91` — 9 breaking, 4 info - the response property `message/records_cited/citations/items/hit_url` became nullable for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/record/breadcrumbs` became nullable for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/record/title` became nullable for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/record/url` became nullable for the status `200` (media type: application/json) - the response property `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/chat_session_id` became nullable for the status `200` (media type: text/event-stream) - the response property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/hit_url` became nullable for the status `200` (media type: text/event-stream) - the response property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/record/breadcrumbs` became nullable for the status `200` (media type: text/event-stream) - the response property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/record/title` became nullable for the status `200` (media type: text/event-stream) - the response property `oneOf[#/components/schemas/ChatResultRecordsCitedEvent]/data/citations/items/record/url` became nullable for the status `200` (media type: text/event-stream) - the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/hit_url` became nullable - the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/record/breadcrumbs` became nullable - the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/record/title` became nullable - the request property `chat_session/messages/items/oneOf[subschema #2: Assistant Message]/records_cited/citations/items/record/url` became nullable - **2024-02-06** `46e1f971a1e4` — 1 breaking, 2 info - removed `subschema #1: turbo, subschema #2: auto` from the `chat_mode` request property `oneOf` list - added `subschema #1: ChatModeOptions, subschema #2` to the `chat_mode` request property `oneOf` list - added the required property `message/role` to the response with the `200` status - **2024-02-06** `771f1cbc5bbe` — 1 breaking - the response property `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` became nullable for the status `200` - **2024-02-06** `d6c01b5ee485` — 1 breaking, 1 info - removed `subschema #1, subschema #2` from the `chat_mode` request property `oneOf` list - added `subschema #1: turbo, subschema #2: auto` to the `chat_mode` request property `oneOf` list - **2024-02-06** `93b77d3628e9` — 1 breaking, 2 info - removed `subschema #1, subschema #2` from the `chat_mode` request property `oneOf` list - the `chat_mode` request property default value `auto` was removed - added `subschema #1, subschema #2` to the `chat_mode` request property `oneOf` list - **2024-02-06** `e910bce29ade` — 3 breaking, 2 info - removed the enum value `auto` of the request property `chat_mode` - removed the enum value `turbo` of the request property `chat_mode` - the `chat_mode` request property type changed from `string` to no type - added `subschema #1, subschema #2` to the `chat_mode` request property `oneOf` list - added the optional property `oneOf[#/components/schemas/ChatResultMessageChunkEvent]/data/finish_reason` to the response with the `200` status - **2024-02-06** `3dc3f630bb31` — 1 breaking, 2 info - request property `chat_mode` was restricted to a list of enum values - added the new `auto` enum value to the request property `chat_mode` - added the new `turbo` enum value to the request property `chat_mode` - **2024-02-06** `757e4f199cf3` — 1 breaking, 2 info - removed the required property `message/role` from the response with the `200` status - api operation id `createChatSessionWithChatResult` removed and replaced with `create` - api tag `chat_session` added - **2024-02-06** `17c344f7ac45` — 13 breaking, 2 warning, 14 info - the `chat_session/messages` request property's minItems was increased to `1` - the `chat_session/messages/items/` request property type changed from `object` to no type - added `#/components/schemas/ChatResultMessageChunkEvent, #/components/schemas/ChatResultRecordsCitedEvent` 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: text/event-stream) - the response property `message/records_cited` became optional for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/hit_url` became optional for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/record/title` became optional for the status `200` (media type: application/json) - the response property `message/records_cited/citations/items/record/url` became optional for the status `200` (media type: application/json) - added `subschema #1, subschema #2` to the `detail/items/loc/items/` response property `oneOf` list for the response status `422` - added `subschema #1: RecordTypeEnumerated, subschema #2: other` to the `message/records_cited/citations/items/record/type` response property `oneOf` list for the response status `200` (media type: application/json) - the `message/records_cited/citations/items/record/type` response's property type changed from `string` to no type for status `200` (media type: application/json) - removed the required property `data` from the response with the `200` status (media type: text/event-stream) - removed the required property `event` from the response with the `200` status (media type: text/event-stream) - removed the request property `chat_session/messages/items/content` - removed the request property `chat_session/messages/items/role` - api operation id `createChatSessionAndChatResult` removed and replaced with `createChatSessionWithChatResult` - added discriminator to `chat_session/messages/items/` request property - added `#/components/schemas/UserMessage, #/components/schemas/AssistantMessage` to the `chat_session/messages/items/` request property `oneOf` list - added response discriminator for the response status `200` (media type: text/event-stream) - removed `subschema #1, subschema #2` from the `detail/items/loc/items/` response property `anyOf` list for the response status `422` - removed the `discord_forum_post` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `discord_message` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `discourse_post` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `documentation` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `github_discussion` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `github_issue` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `site` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - removed the `stackoverflow_question` enum value from the `message/records_cited/citations/items/record/type` response property for the response status `200` (media type: application/json) - added the required property `message/role` to the response with the `200` status (media type: application/json) --- [Operation](https://skmtc.dev/inkeep/apis/inkeep-search-and-chat-api/docs/v0/chat_sessions/chat_results/post.md) · [API](https://skmtc.dev/inkeep/apis/inkeep-search-and-chat-api.md) · [Page](https://skmtc.dev/inkeep/apis/inkeep-search-and-chat-api/changes/v0/chat_sessions/chat_results/post)