---
title: "Changes to Create a decision"
method: POST
path: "/decisions"
---

# Changes to Create a decision

`POST /decisions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 88 revisions.

- **2026-10-22** `5d916f45a719`: 4 warning, 5 info
- **2026-10-15** `a8f5f3900b77`: 9 info
- **2026-10-15** `71477f87a870`: 4 info
- **2026-10-08** `7b84603f1bd8`: 1 warning
- **2026-10-06** `8d58d96ecab4`: 1 warning
- **2026-10-06** `8882e25095c8`: 1 info

## Changes

- **2026-10-22** `5d916f45a719`: 4 warning, 5 info
  - removed the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content`
  - removed the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/phase`
  - removed the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/role`
  - removed the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/type`
  - added discriminator to `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/` request property
  - request property `questions/items/oneOf[#/components/schemas/QuestionParamChoice]/instructions` list-of-types was widened by adding types `array` to media type `application/json`
  - request property `questions/items/oneOf[#/components/schemas/QuestionParamPredicate]/instructions` list-of-types was widened by adding types `array` to media type `application/json`
  - request property `questions/items/oneOf[#/components/schemas/QuestionParamScore]/instructions` list-of-types was widened by adding types `array` to media type `application/json`
  - added `#/components/schemas/DecisionInputUserMessage, #/components/schemas/DecisionInputDeveloperMessage, #/components/schemas/DecisionInputSystemMessage, #/components/schemas/DecisionInputAssistantMessage` to the `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/` request property `oneOf` list
- **2026-10-15** `a8f5f3900b77`: 9 info
  - added the new optional request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/phase`
  - the `role` request property default value `user` was removed
  - added `function_call, function_call_output, custom_tool_call, custom_tool_call_output` discriminator mapping keys to the `input/oneOf[subschema #2]/items/` request property
  - added `output_text, refusal` discriminator mapping keys to the `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content/oneOf[subschema #2: Parts]/items/` request property
  - added the new `assistant` enum value to the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/role`
  - added the new `developer` enum value to the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/role`
  - added the new `system` enum value to the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/role`
  - added `#/components/schemas/DecisionInputFunctionCall, #/components/schemas/DecisionInputFunctionCallOutput, #/components/schemas/DecisionInputCustomToolCall, #/components/schemas/DecisionInputCustomToolCallOutput` to the `input/oneOf[subschema #2]/items/` request property `oneOf` list
  - added `#/components/schemas/DecisionInputOutputText, #/components/schemas/DecisionInputRefusal` to the `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content/oneOf[subschema #2: Parts]/items/` request property `oneOf` list
- **2026-10-15** `71477f87a870`: 4 info
  - added the new optional request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content/oneOf[subschema #2: Parts]/items/oneOf[#/components/schemas/DecisionInputImage]/prompt_cache_breakpoint`
  - added the new optional request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content/oneOf[subschema #2: Parts]/items/oneOf[#/components/schemas/DecisionInputText]/prompt_cache_breakpoint`
  - added the new optional request property `prompt_cache_key`
  - added the new optional request property `prompt_cache_options`
- **2026-10-08** `7b84603f1bd8`: 1 warning
  - changed the pattern of the request property `input/oneOf[subschema #2]/items/oneOf[#/components/schemas/DecisionInputMessage]/content/oneOf[subschema #2: Parts]/items/oneOf[#/components/schemas/DecisionInputImage]/image_url` from `^data:` to `^(data:|https?://)`
- **2026-10-06** `8d58d96ecab4`: 1 warning
  - removed the optional property `usage/compute_units` from the response with the `200` status
- **2026-10-06** `8882e25095c8`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/omnistack-sh/apis/openai-api/docs/decisions/post.md) - [API](https://skmtc.dev/omnistack-sh/apis/openai-api.md) - [Page](https://skmtc.dev/omnistack-sh/apis/openai-api/changes/decisions/post)