Responses

List input items

Returns a list of input items for a given response.

get/responses/{response_id}/input_items

Path parameters

response_idstring required

The ID of the response to retrieve input items for.

Query parameters

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

order'asc' | 'desc'

The order to return the input items in. Default is desc.

asc: Return the input items in ascending order.
desc: Return the input items in descending order.

afterstring

An item ID to list items after, used in pagination.

includeIncludeEnum[]

Additional fields to include in the response. See the include parameter for Response creation above for more information.

Response

object'list' required

The type of object returned, must be list.

has_moreboolean required

Whether there are more items available.

first_idstring required

The ID of the first item in the list.

last_idstring required

The ID of the last item in the list.

Changes

Changed in 5 of the 31 revisions of this API.2649

Jul 9, 2026e0508a503b84340See the full diff
- ●
  added the new auto enum value to the data/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 data/items/anyOf[InputMessageResource]/allOf[subschema #1: Input message]/content/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 data/items/anyOf[subschema #27: ResponseCustomToolCallOutputItem -> subschema #29: 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 optional property data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/items/anyOf[FunctionToolCallResource]/allOf[subschema #1: Function tool call]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[InputMessageResource]/allOf[subschema #1: Input message]/content/items/anyOf[subschema #1: Input text]/prompt_cache_breakpoint to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[InputMessageResource]/allOf[subschema #1: Input message]/content/items/anyOf[subschema #2: Input image]/prompt_cache_breakpoint to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[InputMessageResource]/allOf[subschema #1: Input message]/content/items/anyOf[subschema #3: Input file]/prompt_cache_breakpoint to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/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 data/items/anyOf[subschema #18: Shell tool call -> subschema #20: Shell tool call]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #19: Shell call output -> subschema #21: Shell call output]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #20: Apply patch tool call -> subschema #22: Apply patch tool call]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #21: Apply patch tool call output -> subschema #23: Apply patch tool call output]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #26: ResponseCustomToolCallItem -> subschema #28: ResponseCustomToolCallItem]/allOf[subschema #1: Custom tool call]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #27: ResponseCustomToolCallOutputItem -> subschema #29: ResponseCustomToolCallOutputItem]/allOf[subschema #1: Custom tool call output]/caller to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/anyOf[subschema #27: ResponseCustomToolCallOutputItem -> subschema #29: 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 data/items/anyOf[subschema #27: ResponseCustomToolCallOutputItem -> subschema #29: 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 data/items/anyOf[subschema #27: ResponseCustomToolCallOutputItem -> subschema #29: 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 Program ProgramOutput to the data/items/ response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added ProgrammaticToolCallingParam to the data/items/anyOf[AdditionalTools]/tools/items/ response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  added ProgrammaticToolCallingParam to the data/items/anyOf[ToolSearchOutput]/tools/items/ response property anyOf list for the response status 200
  response-property-any-of-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 17, 2026827fa3e74ce92See the full diff
- ○
  added the optional property data/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 data/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #6: MCP tool]/tunnel_id to the response with the 200 status
  response-optional-property-added
Jun 1, 2026d96e76a894f812See the full diff
- ▲
  the response property data/items/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query became optional for the status 200
  response-property-became-optional
- ○
  added AdditionalTools to the data/items/ response property anyOf list for the response status 200
  response-property-any-of-added
- ○
  response property data/items/anyOf[subschema #6: Web search tool call]/action/anyOf[subschema #1: Search action]/query deprecated
  response-property-deprecated
May 7, 2026737fbb7f6f1734See the full diff
- ●
  added the new chatgpt-image-latest enum value to the data/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 data/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 data/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
- ○
  removed the 1024x1024 enum value from the data/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 data/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 data/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 data/items/anyOf[ToolSearchOutput]/tools/items/anyOf[subschema #8: Image generation tool]/size response property for the response status 200
  response-property-enum-value-removed
May 6, 20261b5c6501b84711See the full diff
- ▲
  the data/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 data/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

Full history