---
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 1 of 2 revisions.

- **2026-11-03** `d63ac1749ae7`: 20 breaking, 13 warning, 16 info

## Changes

- **2026-11-03** `d63ac1749ae7`: 20 breaking, 13 warning, 16 info
  - added `#/components/schemas/RequestMetadata` to the `metadata` request property `allOf` list
  - the `metadata` request property type changed from `object` to no type
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[#/components/schemas/ResponseInputObject]/messages/items/content/oneOf[subschema #2]/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[#/components/schemas/ResponseInputObject]/messages/items/content/oneOf[subschema #2]/items/` response property `oneOf` list for the response status `202`
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[subschema #2]/items/content/oneOf[subschema #2]/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[subschema #2]/items/content/oneOf[subschema #2]/items/` response property `oneOf` list for the response status `202`
  - added `#/components/schemas/ResponseUsage, subschema #2` to the `usage` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/ResponseUsage, subschema #2` to the `usage` response property `oneOf` list for the response status `202`
  - the `usage` response's property type changed from `object` to no type for status `200`
  - the `usage` response's property type changed from `object` to no type for status `202`
  - removed the required property `usage/input_tokens` from the response with the `200` status
  - removed the required property `usage/input_tokens` from the response with the `202` status
  - removed the required property `usage/input_tokens_details` from the response with the `200` status
  - removed the required property `usage/input_tokens_details` from the response with the `202` status
  - removed the required property `usage/output_tokens` from the response with the `200` status
  - removed the required property `usage/output_tokens` from the response with the `202` status
  - removed the required property `usage/output_tokens_details` from the response with the `200` status
  - removed the required property `usage/output_tokens_details` from the response with the `202` status
  - removed the required property `usage/total_tokens` from the response with the `200` status
  - removed the required property `usage/total_tokens` from the response with the `202` status
  - removed the request property `metadata/completion_webhook`
  - removed the request property `metadata/completion_window`
  - removed the request property `metadata/webhook_token`
  - removed the optional property `usage/completion_tokens` from the response with the `200` status
  - removed the optional property `usage/completion_tokens` from the response with the `202` status
  - removed the optional property `usage/prompt_tokens` from the response with the `200` status
  - removed the optional property `usage/prompt_tokens` from the response with the `202` status
  - added the new `in_progress` enum value to the `status` response property for the response status `200`
  - added the new `in_progress` enum value to the `status` response property for the response status `202`
  - added the new `incomplete` enum value to the `status` response property for the response status `200`
  - added the new `incomplete` enum value to the `status` response property for the response status `202`
  - added the new `queued` enum value to the `status` response property for the response status `200`
  - added the new `queued` enum value to the `status` response property for the response status `202`
  - added the new optional `header` request parameter `X-Sail-Completion-Window`
  - added the new `max` enum value to the request property `reasoning/effort`
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[#/components/schemas/ResponseInputObject]/messages/items/content/oneOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/ResponseInputFilePart` to the `input/oneOf[subschema #2]/items/content/oneOf[subschema #2]/items/` request property `oneOf` list
  - added the non-success response with the status `409`
  - added the non-success response with the status `503`
  - added the optional property `metadata/supercache_write_input_tokens` to the response with the `200` status
  - …9 more

---

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