---
title: "Changes to Create Response"
method: POST
path: "/v1/responses"
---

# Changes to Create Response

`POST /v1/responses`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 5 revisions.

- **2025-12-15** `921a3ac63a09` — 1 breaking, 1 warning, 25 info
- **2025-11-12** `a66a62e95597` — 2 info

## Changes

- **2025-12-15** `921a3ac63a09` — 1 breaking, 1 warning, 25 info
  - the request's body type changed from no type to `object`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4` from the request body `allOf` list
  - added the new optional request property `context_editing`
  - added the new optional request property `image_generation`
  - added the new optional request property `include`
  - added the new optional request property `input`
  - added the new optional request property `instructions`
  - added the new optional request property `max_output_tokens`
  - added the new optional request property `max_tool_calls`
  - added the new optional request property `model`
  - added the new optional request property `parallel_tool_calls`
  - added the new optional request property `prompt_cache_key`
  - added the new optional request property `reasoning`
  - added the new optional request property `reasoning_options`
  - added the new optional request property `safety_identifier`
  - added the new optional request property `service_tier`
  - added the new optional request property `stream`
  - added the new optional request property `stream_options`
  - added the new optional request property `temperature`
  - added the new optional request property `text`
  - added the new optional request property `tool_choice`
  - added the new optional request property `tools`
  - added the new optional request property `top_k`
  - added the new optional request property `top_logprobs`
  - added the new optional request property `top_p`
  - added the new optional request property `truncation`
  - added the new optional request property `user`
- **2025-11-12** `a66a62e95597` — 2 info
  - added `subschema #5` to the `allOf[subschema #3]/tools/items/` request property `anyOf` list
  - added the new `web_search` enum value to the request property `allOf[subschema #3]/tool_choice/anyOf[subschema #3]/type`

---

[Operation](https://skmtc.dev/helicone/apis/helicone-ai-gateway-api/docs/v1/responses/post.md) · [API](https://skmtc.dev/helicone/apis/helicone-ai-gateway-api.md) · [Page](https://skmtc.dev/helicone/apis/helicone-ai-gateway-api/changes/v1/responses/post)
