Skip to main content
POST
/
v1
/
retrievers
/
executions
/
list
List Adhoc Executions
curl --request POST \
  --url https://api.mixpeek.com/v1/retrievers/executions/list \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "completed",
  "start_time": "<unknown>",
  "end_time": "<unknown>"
}
'
{
  "pagination": "<unknown>",
  "results": [
    {
      "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>"
      ]
    }
  ],
  "total": 0
}

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"

Query Parameters

​
limit
integer | null
Required range: 1 <= x <= 1000
​
offset
integer | null
Required range: 0 <= x <= 10000
​
cursor
string | null
​
include_total
boolean
default:false

Body

application/json

Request to list ad-hoc retriever executions with filtering.

Allows filtering by status, time range, and searching by query summary. Results are ordered by timestamp descending (most recent first).

​
status
string | null

Filter by execution status. Common values: 'completed', 'failed'. OPTIONAL - omit to see all statuses.

Example:

"completed"

​
start_time
any | null

Filter executions after this timestamp (inclusive). OPTIONAL - omit for no start time filter.

​
end_time
any | null

Filter executions before this timestamp (inclusive). OPTIONAL - omit for no end time filter.

Response

Successful Response

Response from listing ad-hoc retriever executions.

​
pagination
any
required

Pagination metadata.

​
results
AdhocExecutionSummary · object[]

List of ad-hoc execution summaries.

​
total
integer
default:0

Total number of ad-hoc executions matching filters.