Adhoc Retrievers

Get Adhoc Execution

Changed on

Get detailed execution information for a specific ad-hoc retriever execution.

Returns comprehensive execution details including: - Execution metadata (status, duration, credits used) - Performance metrics (documents processed/returned, cache hit rate) - Input data and query summary - Stage completion information - Collections queried

Use Cases: - Debug specific ad-hoc executions - Analyze performance of a particular query - Retrieve execution inputs for reproduction - Audit ad-hoc retriever usage

Raises: 404 NotFoundError: If execution not found or not an ad-hoc execution

get/v1/retrievers/executions/{execution_id}

Request

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

Path parameters

execution_idstring required

Execution identifier.

Response

Successful Response

execution_idstring required

Unique execution identifier.

execution_modestring required

Execution mode ('adhoc').

statusstring required

Execution status ('completed', 'failed', etc.).

timestampunknown required
duration_msnumber required

Total execution duration in milliseconds.

credits_usednumber required

Credits consumed during execution.

total_processedinteger required

Total documents processed across all stages.

total_returnedinteger required

Number of documents returned in final results.

cache_hit_ratenumber nullable

Cache hit rate across stages (0.0-1.0).

query_summarystring nullable

Brief summary of the query inputs.

stages_completedinteger required

Number of stages completed.

total_stagesinteger required

Total number of stages in the pipeline.

collection_idsstring[]

Collections queried during execution.

inputsstring nullable

Full input data provided for execution.

inputs_hashstring nullable

SHA-1 hash of inputs for deduplication.

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