responses

Create a response

Create a text response with function and Mixedbread hosted-store tools.

post/v1/responses

Request body

modelstring

instructionsstring nullable

storeboolean

previous_response_idstring nullable

streamboolean

temperaturenumber nullable

top_pnumber nullable

max_output_tokensinteger nullable

max_tool_callsinteger nullable

parallel_tool_callsboolean

metadataobject nullable

includestring[] nullable

backgroundboolean

truncation'auto' | 'disabled'

service_tier'auto' | 'default' | 'flex' | 'scale' | 'priority' nullable

safety_identifierstring nullable

prompt_cache_keystring nullable

userstring nullable

client_metadataobject nullable

Example request

{
  "tools": [
    {
      "filters": {
        "all": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ],
        "any": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ],
        "none": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ]
      }
    }
  ]
}

Response

The generated response, or a semantic server-sent event stream

idstring required

object'response'

created_atnumber required

status'completed' | 'failed' | 'in_progress' | 'cancelled' | 'queued' | 'incomplete' required

completed_atnumber nullable

instructionsstring nullable

modelstring

parallel_tool_callsboolean

temperaturenumber nullable

top_pnumber nullable

backgroundboolean

max_output_tokensinteger nullable

max_tool_callsinteger nullable

previous_response_idstring nullable

service_tier'auto' | 'default' | 'flex' | 'scale' | 'priority'

truncation'auto' | 'disabled'

metadataobject nullable

safety_identifierstring nullable

prompt_cache_keystring nullable

userstring nullable

titlestring nullable

Example response

{
  "hosted_tools": [
    {
      "filters": {
        "all": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ],
        "any": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ],
        "none": [
          {
            "key": "price",
            "operator": "gt",
            "value": "100"
          },
          {
            "key": "color",
            "operator": "eq",
            "value": "red"
          }
        ]
      }
    }
  ]
}

Changes

Changed in 10 of the 30 revisions of this API.295574

Sep 10, 2026adde8ecfa74f16See the full diff
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the request property ///
  request-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 5, 2026ea8d85b8caca1108See the full diff
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property /// from the response with the status
  response-optional-property-removed
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added mcp discriminator mapping keys to the / request property
  request-property-discriminator-mapping-added
- ○
  added mcp_approval_request mcp_approval_response mcp_call mcp_list_tools discriminator mapping keys to the // request property
  request-property-discriminator-mapping-added
- ○
  added to the / request property oneOf list
  request-property-one-of-added
- ○
  added to the // request property oneOf list
  request-property-one-of-added
- ○
  added to the / response property anyOf list for the response status
  response-property-any-of-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added mcp_approval_request mcp_call mcp_list_tools discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Sep 4, 2026eb12b76f5763182929See the full diff
- ▲
  removed subschema #1 from the request property anyOf list
  request-property-any-of-removed
- ▲
  the /// request property's max was decreased to 30.00
  request-property-max-decreased
- ▲
  the /// request property's max was decreased to 30.00
  request-property-max-decreased
- ▲
  the /// request property's max was decreased to 30.00
  request-property-max-decreased
- ▲
  the /// request property's max was decreased to 20.00
  request-property-max-decreased
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ▲
  removed the required property ////// from the response with the status
  response-required-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  removed the optional property ////// from the response with the status
  response-optional-property-removed
- ●
  added the new context_window enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new max_tool_calls enum value to the /// response property for the response status
  response-property-enum-value-added
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  the request property default value changed from 10 to 5
  request-property-default-value-changed
- ○
  the request property default value changed from 30 to 10
  request-property-default-value-changed
- ○
  the request property default value changed from 5 to 8
  request-property-default-value-changed
- ○
  request property / deprecated
  request-property-deprecated
- ○
  request property / deprecated
  request-property-deprecated
- ○
  request property / deprecated
  request-property-deprecated
- ○
  request property / deprecated
  request-property-deprecated
- ○
  request property // deprecated
  request-property-deprecated
- ○
  request property // deprecated
  request-property-deprecated
- ○
  request property // deprecated
  request-property-deprecated
- ○
  request property // deprecated
  request-property-deprecated
- ○
  added filter_chunks get_chunks grep inspect_metadata search_corpus discriminator mapping keys to the / request property
  request-property-discriminator-mapping-added
- ○
  added to the / request property oneOf list
  request-property-one-of-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added to the / response property anyOf list for the response status
  response-property-any-of-added
- ○
  the response's property default value changed from 10 to 5 for the status
  response-property-default-value-changed
- ○
  the response's property default value changed from 30 to 10 for the status
  response-property-default-value-changed
- ○
  the response's property default value changed from 5 to 8 for the status
  response-property-default-value-changed
- ○
  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
- ○
  response property hosted_tools/items/anyOf[subschema #1: StoreSearchTool -> subschema #6: StoreSearchTool]/ deprecated
  response-property-deprecated
- ○
  response property hosted_tools/items/anyOf[subschema #2: StoreGrepTool -> subschema #7: StoreGrepTool]/ deprecated
  response-property-deprecated
- ○
  response property hosted_tools/items/anyOf[subschema #3: StoreListChunksTool -> subschema #8: StoreListChunksTool]/ deprecated
  response-property-deprecated
- ○
  response property hosted_tools/items/anyOf[subschema #4: MetadataFacetsTool -> subschema #9: MetadataFacetsTool]/ deprecated
  response-property-deprecated
- ○
  added filter_chunks_call get_chunks_call grep_call inspect_metadata_call search_corpus_call discriminator mapping keys to the / response property for the response status
  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, 2026f66774ddecfc1See the full diff
- ○
  endpoint added
  endpoint-added
Aug 13, 2026d47e1d8525491See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 12, 2026ff7d87258f3213See the full diff
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ○
  added reasoning sources discriminator mapping keys to the // request property
  request-property-discriminator-mapping-added
- ○
  added to the // request property oneOf list
  request-property-one-of-added
- ○
  added reasoning sources discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
Aug 4, 20262eece97b5ae5311See the full diff
- ▲
  removed from the // request property oneOf list
  request-property-one-of-removed
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  added store_grep store_list_chunks store_metadata_facets discriminator mapping keys to the / request property
  request-property-discriminator-mapping-added
- ○
  added store_grep_call store_list_chunks_call store_metadata_facets_call discriminator mapping keys to the // request property
  request-property-discriminator-mapping-added
- ○
  mapped value for discriminator key store_search_call changed from to for // request property
  request-property-discriminator-mapping-changed
- ○
  added to the / request property oneOf list
  request-property-one-of-added
- ○
  added to the // request property oneOf list
  request-property-one-of-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added store_grep store_list_chunks store_metadata_facets discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
- ○
  added store_grep_call store_list_chunks_call store_metadata_facets_call discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
- ○
  mapped value for discriminator key store_search_call changed from to for / response property for the response status
  response-property-discriminator-mapping-changed
- ○
  removed from the / response property oneOf list for the response status
  response-property-one-of-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 1, 2026d13e684fd1c92See the full diff
- ○
  added the new optional request property ///////
  new-optional-request-property
- ○
  added the optional property ////// to the response with the status
  response-optional-property-added
Jul 31, 2026c6cc661737c3519See the full diff
- ▲
  the response property /// became optional for the status
  response-property-became-optional
- ▲
  response property tools/items/oneOf[subschema #1: StoreSearchTool]/store_identifiers list-of-types was widened by adding types null to media type application/json of response 200
  response-property-list-of-types-widened
- ▲
  added to the ///// response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ▲
  added to the / response property oneOf list for the response status
  response-property-one-of-added
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ////
  new-optional-request-property
- ○
  added the new optional request property ///
  new-optional-request-property
- ○
  added to the request property anyOf list
  request-property-any-of-added
- ○
  the request property /// became optional
  request-property-became-optional
- ○
  added input_file input_image discriminator mapping keys to the ////// request property
  request-property-discriminator-mapping-added
- ○
  added list_stores discriminator mapping keys to the / request property
  request-property-discriminator-mapping-added
- ○
  added list_stores_call discriminator mapping keys to the // request property
  request-property-discriminator-mapping-added
- ○
  request property /// list-of-types was widened by adding types null to media type application/json
  request-property-list-of-types-widened
- ○
  added to the ////// request property oneOf list
  request-property-one-of-added
- ○
  added to the // request property oneOf list
  request-property-one-of-added
- ○
  added to the / request property oneOf list
  request-property-one-of-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added the optional property /// to the response with the status
  response-optional-property-added
- ○
  added to the response property anyOf list for the response status
  response-property-any-of-added
- ○
  added input_file input_image discriminator mapping keys to the ///// response property for the response status
  response-property-discriminator-mapping-added
- ○
  added list_stores discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
- ○
  added list_stores_call discriminator mapping keys to the / response property for the response status
  response-property-discriminator-mapping-added
Jul 26, 2026587cbdf607b01See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog