---
title: "Changes to Generates a response based on text or image prompts. The response ID can be used to retrieve the response later or to continue the conversation without repeating prior context. New responses will be stored for 30 days and then permanently deleted."
method: POST
path: "/v1/responses"
---

# Changes to Generates a response based on text or image prompts. The response ID can be used to retrieve the response later or to continue the conversation without repeating prior context. New responses will be stored for 30 days and then permanently deleted.

`POST /v1/responses`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 3 of 9 revisions.

- **2026-08-26** `7df26eaf5d7c` — 3 breaking, 3 info
- **2026-08-22** `0b56d0413ce0` — 2 info
- **2026-07-26** `7e0c8f28dfba` — 1 info

## Changes

- **2026-08-26** `7df26eaf5d7c` — 3 breaking, 3 info
  - removed `subschema #1, subschema #7` from the `tools/items/` request property `oneOf` list
  - added `subschema #1, subschema #7, subschema #9` to the `tools/items/` response property `oneOf` list for the response status `200`
  - added `subschema #11, subschema #12` to the `output/items/` response property `oneOf` list for the response status `200`
  - added `subschema #1, subschema #7, subschema #9` to the `tools/items/` request property `oneOf` list
  - added `subschema #11, subschema #12` to the `input/oneOf[subschema #2]/items/oneOf[subschema #2]/allOf[#/components/schemas/ModelOutput]/` request property `oneOf` list
  - removed `subschema #1, subschema #7` from the `tools/items/` response property `oneOf` list for the response status `200`
- **2026-08-22** `0b56d0413ce0` — 2 info
  - added the new optional request property `tools/items/oneOf[subschema #1]/allOf[#/components/schemas/FunctionDefinition]/defer_loading`
  - added the optional property `tools/items/oneOf[subschema #1]/allOf[#/components/schemas/FunctionDefinition]/defer_loading` to the response with the `200` status
- **2026-07-26** `7e0c8f28dfba` — 1 info
  - added the new optional request property `reasoning_effort`

---

[Operation](https://skmtc.dev/x/apis/xai-s-rest-api/docs/v1/responses/post.md) · [API](https://skmtc.dev/x/apis/xai-s-rest-api.md) · [Page](https://skmtc.dev/x/apis/xai-s-rest-api/changes/v1/responses/post)