---
title: "Changes to Create a response"
method: POST
path: "/responses"
---

# Changes to Create a response

`POST /responses`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 28 revisions.

- **2026-10-15** `576581ede708`: 1 breaking, 1 info
- **2026-10-10** `8e1cf4215359`: 1 breaking, 3 info
- **2026-09-30** `701e020d7eab`: 1 breaking, 1 info
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
- **2026-09-12** `6205c7327cde`: 1 info
- **2026-09-03** `479cef79737f`: 1 breaking, 1 info
- **2026-08-28** `0d3587e9a7c8`: 1 breaking, 1 info
- **2026-08-22** `fd9d80e384a8`: 1 breaking, 2 warning
- **2026-07-31** `5dbd6e8473c9`: 1 warning
- **2026-07-26** `c0926990c662`: 1 info

## Changes

- **2026-10-15** `576581ede708`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #15` from the response body `oneOf` list for the response status `200`
- **2026-10-10** `8e1cf4215359`: 1 breaking, 3 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #9, subschema #10, subschema #12, subschema #13, subschema #14` to the response body `oneOf` list for the response status `200`
  - added the new optional request property `tools`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #9, subschema #10` from the response body `oneOf` list for the response status `200`
  - added the non-success response with the status `422`
- **2026-09-30** `701e020d7eab`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11, subschema #12` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7, subschema #8, subschema #9, subschema #10, subschema #11` from the response body `oneOf` list for the response status `200`
- **2026-09-17** `b8591e05c0ba`: 1 warning, 1 info
  - deleted the `header` request parameter `x-api-key`
  - the endpoint scheme security `x-api-key` was added to the API
- **2026-09-12** `6205c7327cde`: 1 info
  - api operation id `create-stream` removed and replaced with `responses_create_stream`
- **2026-09-03** `479cef79737f`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #10` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #10` from the response body `oneOf` list for the response status `200`
- **2026-08-28** `0d3587e9a7c8`: 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #9, subschema #10` to the response body `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #9, subschema #10` from the response body `oneOf` list for the response status `200`
- **2026-08-22** `fd9d80e384a8`: 1 breaking, 2 warning
  - the `input/items/content` request property's minLength was increased from `0` to `1`
  - the `input/items/content` request property's maxLength was set to `10000`
  - the `instructions` request property's maxLength was set to `2000`
- **2026-07-31** `5dbd6e8473c9`: 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/docs/responses/post.md) - [API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) - [Page](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/responses/post)