Retrievers

Get Execution Query Profile (explain-on-execute read path)

Changed on

Return the query profile for a PAST execution, by execution_id — the same plan that explain=true returns inline at execute time, read back later. Contains per-stage timings + input/output counts, MVS execution stats, the optimizer summary, and (as it is wired) the shard ExecutionTrace (chosen legs, fusion, push-downs, nprobe, served/shadow planner). Reads the query_profile stored on the execution's record in the mxp_retriever_executions collection. Returns 404 if the execution has no captured profile. This is the queryable, Studio-friendly counterpart to inline explain.

get/v1/retrievers/{retriever_id}/executions/{execution_id}/profile

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/retrievers/{retriever_id}/executions/{execution_id}/profile
  • Auth: HTTP bearer and API key in header X-Namespace

Path parameters

retriever_idstring required

Retriever ID or name.

execution_idstring required

Execution identifier.

Response

Successful Response

object required

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 5d4c905106b4Revision changes
    • info

      the endpoint scheme security BearerAuth AND NamespaceHeader was added to the API