---
title: "Changes to Execute Retriever (Auto-Optimized)"
method: POST
path: "/v1/retrievers/{retriever_id}/execute"
---

# Changes to Execute Retriever (Auto-Optimized)

`POST /v1/retrievers/{retriever_id}/execute`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 56 revisions.

- **2026-09-28** `0fff3e39f57f` — 1 info
- **2026-09-08** `b8cae23569c9` — 1 breaking, 22 info
- **2026-08-09** `5d4c905106b4` — 1 info
- **2026-07-26** `7cb051533311` — 2 info

## Changes

- **2026-09-28** `0fff3e39f57f` — 1 info
  - added the optional property `stage_statistics/stages/additionalProperties/stage_cache_hit` to the response with the `200` status
- **2026-09-08** `b8cae23569c9` — 1 breaking, 22 info
  - the response's body type changed from no type to `object` for status `200`
  - added the optional property `budget` to the response with the `200` status
  - added the optional property `cache_hit` to the response with the `200` status
  - added the optional property `cached_at` to the response with the `200` status
  - added the optional property `diagnostics` to the response with the `200` status
  - added the optional property `documents` to the response with the `200` status
  - added the optional property `enrichment_skip_reason` to the response with the `200` status
  - added the optional property `enrichment_skipped` to the response with the `200` status
  - added the optional property `enrichment_skipped_stages` to the response with the `200` status
  - added the optional property `error` to the response with the `200` status
  - added the optional property `explain_plan` to the response with the `200` status
  - added the optional property `facets` to the response with the `200` status
  - added the optional property `interpretation` to the response with the `200` status
  - added the optional property `learned_fusion_context` to the response with the `200` status
  - added the optional property `optimization_applied` to the response with the `200` status
  - added the optional property `optimization_summary` to the response with the `200` status
  - added the optional property `pagination` to the response with the `200` status
  - added the optional property `results` to the response with the `200` status
  - added the optional property `retriever_id` to the response with the `200` status
  - added the optional property `stage_statistics` to the response with the `200` status
  - added the optional property `warnings` to the response with the `200` status
  - added the required property `execution_id` to the response with the `200` status
  - added the required property `status` to the response with the `200` status
- **2026-08-09** `5d4c905106b4` — 1 info
  - the endpoint scheme security `BearerAuth AND NamespaceHeader` was added to the API
- **2026-07-26** `7cb051533311` — 2 info
  - added the new optional `query` request parameter `skip_cache`
  - added the new optional request property `limit`

---

[Operation](https://skmtc.dev/mixpeek/apis/mixpeek-api/docs/v1/retrievers/:retriever_id/execute/post.md) · [API](https://skmtc.dev/mixpeek/apis/mixpeek-api.md) · [Page](https://skmtc.dev/mixpeek/apis/mixpeek-api/changes/v1/retrievers/:retriever_id/execute/post)