v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Adhoc Retrievers

Get Adhoc Execution

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}

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.).

{"stackTrail":"components:schemas:AdhocExecutionDetail:properties:timestamp","oasType":"schema","type":"unknown","title":"Timestamp","description":"When the execution started (UTC)."}

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.