Get Adhoc Execution

{ "execution_id": "<string>", "execution_mode": "<string>", "status": "<string>", "timestamp": "<unknown>", "duration_ms": 1, "credits_used": 1, "total_processed": 1, "total_returned": 1, "stages_completed": 1, "total_stages": 1, "cache_hit_rate": 0.5, "query_summary": "<string>", "collection_ids": [ "<string>" ], "inputs": "<string>", "inputs_hash": "<string>" }

Headers

Authorization

string

Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Example:

"Bearer YOUR_MIXPEEK_API_KEY"

authorization

string

X-Namespace

string

Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'. Falls back to ?namespace= query parameter if the header is omitted.

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Path Parameters

execution_id

string

required

Execution identifier.

Response

Successful Response

Detailed information about an ad-hoc retriever execution.

Extends AdhocExecutionSummary with full input data and metadata for comprehensive execution analysis.

execution_id

string

required

Unique execution identifier.

execution_mode

string

required

Execution mode ('adhoc').

status

string

required

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

timestamp

any

required

When the execution started (UTC).

duration_ms

number

required

Total execution duration in milliseconds.

Required range: x >= 0

credits_used

number

required

Credits consumed during execution.

Required range: x >= 0

total_processed

integer

required

Total documents processed across all stages.

Required range: x >= 0

total_returned

integer

required

Number of documents returned in final results.

Required range: x >= 0

stages_completed

integer

required

Number of stages completed.

Required range: x >= 0

total_stages

integer

required

Total number of stages in the pipeline.

Required range: x >= 0

cache_hit_rate

number | null

Cache hit rate across stages (0.0-1.0).

Required range: 0 <= x <= 1

query_summary

string | null

Brief summary of the query inputs.

collection_ids

string[]

Collections queried during execution.

inputs

string | null

Full input data provided for execution.

inputs_hash

string | null

SHA-1 hash of inputs for deduplication.