--- title: "Changes to Create a response" method: POST path: "/api/responses" --- # Changes to Create a response `POST /api/responses` > Every recorded change to this operation, newest first. ## Timeline Changed in 7 of 19 revisions. - **2026-10-21** `c30bcb383ee8`: 7 breaking, 13 info - **2026-10-02** `b830b79cfd52`: 3 breaking, 4 info - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - **2026-09-12** `22b868ef3f22`: 1 info - **2026-08-22** `b18c72975097`: 1 warning - **2026-08-13** `4e064cf81dae`: 8 info - **2026-07-31** `c26d550029f8`: 4 breaking, 27 warning, 15 info ## Changes - **2026-10-21** `c30bcb383ee8`: 7 breaking, 13 info - request body became required - the response property `error/code` became nullable for the status `400` - the response property `error/code` became nullable for the status `401` - the response property `error/code` became nullable for the status `422` - the response property `error/param` became nullable for the status `400` - the response property `error/param` became nullable for the status `401` - the response property `error/param` became nullable for the status `422` - api operation id `gateway_createResponse` removed and replaced with `createResponse` - api tag `Gateway` added - api tag `gateway` removed - the request optional property `respan_params/credential_override/additionalProperties/api_key` became write-only - added the new enum value `bedrock` to the `header` request parameter `X-Respan-Route-Provider` - the `cache_ttl` request property format was generalized from `double` to no format - the `respan_params/cache_ttl` request property format was generalized from `double` to no format - removed `subschema #1, subschema #2` from the `error/code` response property `oneOf` list for the response status `400` - removed `subschema #1, subschema #2` from the `error/code` response property `oneOf` list for the response status `401` - removed `subschema #1, subschema #2` from the `error/code` response property `oneOf` list for the response status `422` - removed `subschema #1, subschema #2` from the `error/param` response property `oneOf` list for the response status `400` - removed `subschema #1, subschema #2` from the `error/param` response property `oneOf` list for the response status `401` - removed `subschema #1, subschema #2` from the `error/param` response property `oneOf` list for the response status `422` - **2026-10-02** `b830b79cfd52`: 3 breaking, 4 info - the response's body type changed from no type to `object` for status `400` - the response's body type changed from no type to `object` for status `401` - the response's body type changed from no type to `object` for status `422` - added the non-success response with the status `403` - added the required property `error` to the response with the `400` status - added the required property `error` to the response with the `401` status - added the required property `error` to the response with the `422` status - **2026-09-17** `6fa8242da8c2`: 1 warning, 1 info - deleted the `header` request parameter `Authorization` - the endpoint scheme security `RespanApiKey` was added to the API - **2026-09-12** `22b868ef3f22`: 1 info - api operation id `create-response` removed and replaced with `gateway_createResponse` - **2026-08-22** `b18c72975097`: 1 warning - the `max_steps` request property's min was set to `1.00` - **2026-08-13** `4e064cf81dae`: 8 info - added the new optional request property `cache_enabled` - added the new optional request property `cache_options` - added the new optional request property `cache_ttl` - added the new optional request property `customer_identifier` - added the new optional request property `respan_params/cache_enabled` - added the new optional request property `respan_params/cache_options` - added the new optional request property `respan_params/cache_ttl` - added the new optional request property `respan_params/customer_identifier` - **2026-07-31** `c26d550029f8`: 4 breaking, 27 warning, 15 info - the `X-Respan-Route-Provider` request header's property undefined was restricted to a list of enum values - the `header` request parameter `X-Respan-Route-Provider` was restricted to a list of enum values - removed `#/components/schemas/ApiResponsesPostRequestBodyContentApplicationJsonSchemaInput1` from the `input` request property `oneOf` list - the `tools/items/` request property type changed from `object` to no type - deleted the `header` request parameter `X-Data-Respan-Params` - deleted the `header` request parameter `X-Respan-Beta` - removed the request property `cache_enabled` - removed the request property `cache_options` - removed the request property `cache_ttl` - removed the request property `credential_override` - removed the request property `custom_identifier` - removed the request property `customer_credentials` - removed the request property `customer_identifier` - removed the request property `customer_params` - removed the request property `disable_log` - removed the request property `exclude_models` - removed the request property `exclude_providers` - removed the request property `fallback_models` - removed the request property `instructions` - removed the request property `load_balance_group` - removed the request property `max_output_tokens` - removed the request property `metadata` - removed the request property `positive_feedback` - removed the request property `previous_response_id` - removed the request property `prompt` - removed the request property `properties` - removed the request property `request_breakdown` - removed the request property `retry_params` - removed the request property `temperature` - removed the request property `thread_identifier` - removed the request property `top_p` - added the new optional `query` request parameter `format` - added the new optional request property `language_preference` - added the new optional request property `max_steps` - added the new optional request property `preset` - added the new optional request property `respan_params/credential_override` - added the new optional request property `response_format` - added the new optional request property `skills` - added the new enum value `azure` to the `header` request parameter `X-Respan-Route-Provider` - added the new enum value `openai` to the `header` request parameter `X-Respan-Route-Provider` - …6 more --- [Operation](https://skmtc.dev/keywordsai/apis/respan-api/docs/api/responses/post.md) - [API](https://skmtc.dev/keywordsai/apis/respan-api.md) - [Page](https://skmtc.dev/keywordsai/apis/respan-api/changes/api/responses/post)