Compact a response

Compact a conversation. Returns a compacted response object.

Learn when and how to compact long-running conversations in the conversation state guide. For ZDR-compatible compaction details, see Compaction (advanced).

post/responses/compact

Request body

previous_response_idstring nullable

The unique ID of the previous response to the model. Use this to create multi-turn conversations. Learn more about conversation state. Cannot be used in conjunction with conversation.

instructionsstring nullable

A system (or developer) message inserted into the model's context. When used along with previous_response_id, the instructions from a previous response will not be carried over to the next response. This makes it simple to swap out system (or developer) messages in new responses.

prompt_cache_keystring nullable

A key to use when reading from or writing to the prompt cache.

prompt_cache_retention'in_memory' | '24h'
service_tier'auto' | 'default' | 'fast' | 'flex' | 'priority'

Response

Success

idstring required

The unique identifier for the compacted response.

object'response.compaction' required

The object type. Always response.compaction.

created_atinteger required

Unix timestamp (in seconds) when the compacted conversation was created.

Changes

Changed in 12 of the 31 revisions of this API.385123

    • added the new fast enum value to the request property service_tier/anyOf[ServiceTierEnum]/

      request-property-enum-value-added

  • e0508a503b84290See the full diff
    • added the new auto enum value to the output/items/anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/detail response property for the response status 200

      response-property-enum-value-added

    • added the new auto enum value to the output/items/anyOf[subschema #26: ResponseCustomToolCallOutputItem -> subschema #28: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/detail response property for the response status 200

      response-property-enum-value-added

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #1: Function]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #1: Function]/output_schema

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #1: Function]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #1: Function]/output_schema

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #18: Shell tool call]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #19: Shell tool call output]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #20: Apply patch tool call]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #21: Apply patch tool call output]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #26: Custom tool call output]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #26: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #26: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #26: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #27: Custom tool call]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #7: Function tool call]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/caller

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint

      new-optional-request-property

    • added the new optional request property prompt_cache_options

      new-optional-request-property

    • added ProgramItemParam ProgramOutputItemParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/ request property anyOf list

      request-property-any-of-added

    • added ProgrammaticToolCallingParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/ request property anyOf list

      request-property-any-of-added

    • added ProgrammaticToolCallingParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/ request property anyOf list

      request-property-any-of-added

    • request property prompt_cache_retention/anyOf[PromptCacheRetentionEnum]/ deprecated

      request-property-deprecated

    • added the new auto enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #3: Input file]/detail

      request-property-enum-value-added

    • added the new auto enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #3: Input file]/detail

      request-property-enum-value-added

    • added the new auto enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #26: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/detail

      request-property-enum-value-added

    • added the new auto enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #3: Input file]/detail

      request-property-enum-value-added

    • added the new gpt-5.6-luna enum value to the request property model/anyOf[ModelIdsResponses]/anyOf[ModelIdsShared]/anyOf[ChatModel]/

      request-property-enum-value-added

    • added the new gpt-5.6-sol enum value to the request property model/anyOf[ModelIdsResponses]/anyOf[ModelIdsShared]/anyOf[ChatModel]/

      request-property-enum-value-added

    • added the new gpt-5.6-terra enum value to the request property model/anyOf[ModelIdsResponses]/anyOf[ModelIdsShared]/anyOf[ChatModel]/

      request-property-enum-value-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #1: Function]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #1: Function]/output_schema to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[FunctionToolCallOutputResource]/allOf[subschema #1: Function tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #10: Shell tool -> subschema #11: Shell tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #11: Custom tool -> subschema #12: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[FunctionToolParam]/output_schema to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #12: Namespace -> subschema #13: Namespace]/tools/items/anyOf[subschema #2: Custom tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #15: Apply patch tool -> subschema #16: Apply patch tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #1: Function]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #1: Function]/output_schema to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #6: MCP tool]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #7: Code interpreter]/allowed_callers to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #17: Shell tool call -> subschema #19: Shell tool call]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #18: Shell call output -> subschema #20: Shell call output]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #19: Apply patch tool call -> subschema #21: Apply patch tool call]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #20: Apply patch tool call output -> subschema #22: Apply patch tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #25: Custom tool call -> subschema #27: Custom tool call]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #26: ResponseCustomToolCallOutputItem -> subschema #28: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/caller to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #26: ResponseCustomToolCallOutputItem -> subschema #28: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #26: ResponseCustomToolCallOutputItem -> subschema #28: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #26: ResponseCustomToolCallOutputItem -> subschema #28: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[subschema #3: Function tool call]/caller to the response with the 200 status

      response-optional-property-added

    • added Program ProgramOutput to the output/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • added ProgrammaticToolCallingParam to the output/items/anyOf[AdditionalTools]/tools/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • added ProgrammaticToolCallingParam to the output/items/anyOf[ToolSearchOutput]/tools/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • added the required property usage/input_tokens_details/cache_write_tokens to the response with the 200 status

      response-required-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[AdditionalToolsItemParam]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id

      new-optional-request-property

    • added the new optional request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id

      new-optional-request-property

    • added the optional property output/items/anyOf[AdditionalTools]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id to the response with the 200 status

      response-optional-property-added

    • added the optional property output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id to the response with the 200 status

      response-optional-property-added

    • removed the media type application/x-www-form-urlencoded from the request body

      request-body-media-type-removed

    • the response property output/items/anyOf[subschema #5: Web search tool call]/action/anyOf[subschema #1: Search action]/query became optional for the status 200

      response-property-became-optional

    • added AdditionalToolsItemParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/ request property anyOf list (media type: application/json)

      request-property-any-of-added

    • added AdditionalToolsItemParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/ request property anyOf list (media type: application/x-www-form-urlencoded)

      request-property-any-of-added

    • the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query became optional (media type: application/json)

      request-property-became-optional

    • the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query became optional (media type: application/x-www-form-urlencoded)

      request-property-became-optional

    • request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query deprecated (media type: application/json)

      request-property-deprecated

    • request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query deprecated (media type: application/x-www-form-urlencoded)

      request-property-deprecated

    • added AdditionalTools to the output/items/ response property anyOf list for the response status 200

      response-property-any-of-added

    • response property output/items/anyOf[subschema #5: Web search tool call]/action/anyOf[subschema #1: Search action]/query deprecated

      response-property-deprecated

    • added CompactionTriggerItemParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/ request property anyOf list (media type: application/json)

      request-property-any-of-added

    • added CompactionTriggerItemParam to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/ request property anyOf list (media type: application/x-www-form-urlencoded)

      request-property-any-of-added

    • added the new optional request property service_tier (media type: application/json)

      new-optional-request-property

    • added the new optional request property service_tier (media type: application/x-www-form-urlencoded)

      new-optional-request-property

  • 737fbb7f6f178310See the full diff
    • removed the enum value 1024x1024 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/json)

      request-property-enum-value-removed

    • removed the enum value 1024x1024 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/x-www-form-urlencoded)

      request-property-enum-value-removed

    • removed the enum value 1024x1536 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/json)

      request-property-enum-value-removed

    • removed the enum value 1024x1536 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/x-www-form-urlencoded)

      request-property-enum-value-removed

    • removed the enum value 1536x1024 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/json)

      request-property-enum-value-removed

    • removed the enum value 1536x1024 of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/x-www-form-urlencoded)

      request-property-enum-value-removed

    • removed the enum value auto of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/json)

      request-property-enum-value-removed

    • removed the enum value auto of the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size (media type: application/x-www-form-urlencoded)

      request-property-enum-value-removed

    • added the new chatgpt-image-latest enum value to the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • added the new gpt-image-2 enum value to the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • added the new gpt-image-2-2026-04-21 enum value to the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ response property for the response status 200

      response-property-enum-value-added

    • added the new chatgpt-image-latest enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/json)

      request-property-enum-value-added

    • added the new chatgpt-image-latest enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/x-www-form-urlencoded)

      request-property-enum-value-added

    • added the new gpt-image-2 enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/json)

      request-property-enum-value-added

    • added the new gpt-image-2 enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/x-www-form-urlencoded)

      request-property-enum-value-added

    • added the new gpt-image-2-2026-04-21 enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/json)

      request-property-enum-value-added

    • added the new gpt-image-2-2026-04-21 enum value to the request property input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/model/anyOf[subschema #2]/ (media type: application/x-www-form-urlencoded)

      request-property-enum-value-added

    • removed the 1024x1024 enum value from the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • removed the 1024x1536 enum value from the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • removed the 1536x1024 enum value from the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • removed the auto enum value from the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200

      response-property-enum-value-removed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size request property type/format changed from string/ to / (media type: application/json)

      request-property-type-changed

    • the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response's property type/format changed from string/ to / for status 200

      response-property-type-changed

    • added subschema #1 subschema #2 to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size request property anyOf list (media type: application/json)

      request-property-any-of-added

    • added subschema #1 subschema #2 to the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size request property anyOf list (media type: application/x-www-form-urlencoded)

      request-property-any-of-added

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[ToolSearchOutputItemParam]/tools/items/anyOf[subschema #8: Image generation tool]/size request property type/format was generalized from string/ to / (media type: application/x-www-form-urlencoded)

      request-property-type-generalized

    • added subschema #1 subschema #2 to the output/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property anyOf list for the response status 200

      response-property-any-of-added

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #1: Input message]/content/anyOf[subschema #2: Input item content list]/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #14: Code interpreter tool call]/outputs/anyOf[subschema #1]/items/anyOf[subschema #2: Code interpreter output image]/url request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #14: Code interpreter tool call]/outputs/anyOf[subschema #1]/items/anyOf[subschema #2: Code interpreter output image]/url request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #1: Input message]/content/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #25: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #25: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #25: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #25: Custom tool call output]/output/anyOf[subschema #2: output content list]/items/anyOf[subschema #3: Input file]/file_url request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #2: Output message]/content/items/anyOf[subschema #1: Output text]/annotations/items/anyOf[subschema #2: URL citation]/url request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #2: Output message]/content/items/anyOf[subschema #1: Output text]/annotations/items/anyOf[subschema #2: URL citation]/url request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #2: Input image]/image_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #3: Input file]/file_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/json)

      request-property-type-changed

    • the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[subschema #8: Function tool call output]/output/anyOf[subschema #2]/items/anyOf[subschema #3: Input file]/file_url/anyOf[subschema #1]/ request property type/format changed from string/ to string/uri (media type: application/x-www-form-urlencoded)

      request-property-type-changed