Changes to Retrieve a chat completion

Changed in 8 of the 30 revisions of this API.▲27●39○16

1. Sep 23, 2026824e59bfac1e▲14●2○2
2. Sep 15, 2026957bf8ec8df8○1
3. Sep 11, 2026ce3609b10ef1○2
4. Sep 5, 2026ea8d85b8caca●10
5. Sep 4, 2026eb12b76f5763▲13●27○7
6. Aug 19, 2026f66774ddecfc○1
7. Aug 14, 2026e5ddc69af941○2
8. Aug 13, 2026d47e1d852549○1

What changed

• Sep 23, 2026824e59bfac1e▲14●2○2See the full diff
  • ▲

    added FileCitation UrlCitation to the choices/items/message/annotations/anyOf[subschema #1]/items response property oneOf list for the response status 200

    response-property-one-of-added

  • ▲

    added FileCitation UrlCitation to the transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items response property oneOf list for the response status 200

    response-property-one-of-added

  • ▲

    the choices/items/message/annotations/anyOf[subschema #1]/items response's property type changed from object to no type for status 200

    response-property-type-changed

  • ▲

    the transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items response's property type changed from object to no type for status 200

    response-property-type-changed

  • ▲

    removed the required property choices/items/message/annotations/anyOf[subschema #1]/items/chunk_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property choices/items/message/annotations/anyOf[subschema #1]/items/file_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property choices/items/message/annotations/anyOf[subschema #1]/items/filename from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property choices/items/message/annotations/anyOf[subschema #1]/items/index from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property choices/items/message/annotations/anyOf[subschema #1]/items/store_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/chunk_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/file_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/filename from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/index from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/store_id from the response with the 200 status

    response-required-property-removed

  • ●

    removed the optional property choices/items/message/annotations/anyOf[subschema #1]/items/type from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items/type from the response with the 200 status

    response-optional-property-removed

  • ○

    added discriminator to choices/items/message/annotations/anyOf[subschema #1]/items response property for the response status 200

    response-property-discriminator-added

  • ○

    added discriminator to transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations/items response property for the response status 200

    response-property-discriminator-added

• Sep 15, 2026957bf8ec8df8○1See the full diff
  • ○

    added the optional property choices/items/message/refusal to the response with the 200 status

    response-optional-property-added

• Sep 11, 2026ce3609b10ef1○2See the full diff
  • ○

    added the optional property choices/items/message/annotations to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property transcript/anyOf[subschema #1]/items/oneOf[subschema #4: AssistantMessage]/annotations to the response with the 200 status

    response-optional-property-added

• Sep 5, 2026ea8d85b8caca●10See the full diff
  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #10: ListStoresCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: SearchCorpusCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: GrepCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: FilterChunksCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #4: InspectMetadataCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #5: GetChunksCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #6: StoreSearchCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #7: StoreGrepCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #8: StoreListChunksCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #9: MetadataFacetsCallItem]/reasoning_offset from the response with the 200 status

    response-optional-property-removed

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

• Sep 4, 2026eb12b76f5763▲13●27○7See the full diff
  • ▲

    added SearchCorpusCallItem GrepCallItem FilterChunksCallItem InspectMetadataCallItem GetChunksCallItem to the hosted_tool_calls/items response property oneOf list for the response status 200

    response-property-one-of-added

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/chunk_index from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/file_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/score from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/store_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/chunk_index from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/file_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/score from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/store_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/chunk_index from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/file_id from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/score from the response with the 200 status

    response-required-property-removed

  • ▲

    removed the required property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/store_id from the response with the 200 status

    response-required-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/filename from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/generated_metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/index from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/mime_type from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/ocr_text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/summary from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/results/anyOf[subschema #1]/items/transcription from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/filename from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/generated_metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/index from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/mime_type from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/ocr_text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/summary from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/results/anyOf[subschema #1]/items/transcription from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/filename from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/generated_metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/index from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/metadata from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/mime_type from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/ocr_text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/summary from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/text from the response with the 200 status

    response-optional-property-removed

  • ●

    removed the optional property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/results/anyOf[subschema #1]/items/transcription from the response with the 200 status

    response-optional-property-removed

  • ○

    added the optional property context_management to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property usage/anyOf[subschema #1: CompletionUsage]/completion_tokens_details to the response with the 200 status

    response-optional-property-added

  • ○

    response property hosted_tool_calls/items/oneOf[subschema #1: StoreSearchCallItem -> subschema #6: StoreSearchCallItem]/ deprecated

    response-property-deprecated

  • ○

    response property hosted_tool_calls/items/oneOf[subschema #2: StoreGrepCallItem -> subschema #7: StoreGrepCallItem]/ deprecated

    response-property-deprecated

  • ○

    response property hosted_tool_calls/items/oneOf[subschema #3: StoreListChunksCallItem -> subschema #8: StoreListChunksCallItem]/ deprecated

    response-property-deprecated

  • ○

    response property hosted_tool_calls/items/oneOf[subschema #4: MetadataFacetsCallItem -> subschema #9: MetadataFacetsCallItem]/ deprecated

    response-property-deprecated

  • ○

    added filter_chunks_call get_chunks_call grep_call inspect_metadata_call search_corpus_call discriminator mapping keys to the hosted_tool_calls/items response property for the response status 200

    response-property-discriminator-mapping-added

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

• Aug 19, 2026f66774ddecfc○1See the full diff
  • ○

    added the optional property transcript to the response with the 200 status

    response-optional-property-added

• Aug 14, 2026e5ddc69af941○2See the full diff
  • ○

    added the optional property tool_tickets to the response with the 200 status

    response-optional-property-added

  • ○

    added the optional property usage/anyOf[subschema #1: CompletionUsage]/prompt_tokens_details to the response with the 200 status

    response-optional-property-added

• Aug 13, 2026d47e1d852549○1See the full diff
  • ○

    endpoint added

    endpoint-added

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