Skip to main content
GET
/
v1
/
retrievers
/
executions
/
{execution_id}
Get Adhoc Execution
curl --request GET \
  --url https://api.mixpeek.com/v1/retrievers/executions/{execution_id}
{
  "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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Headers

​
Authorization
string

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

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_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.