v5

latestOpenAPI 3.1.02026-08-025631,1012.8 MB

Adhoc Retrievers

List Adhoc Executions

List execution history for ad-hoc retrievers.

Returns execution history for all ad-hoc retriever executions in the namespace, sorted by timestamp descending (most recent first).

Use Cases: - Track ad-hoc retriever usage across the namespace - Debug ad-hoc retriever executions - Analyze query patterns from ad-hoc searches - Monitor performance of ad-hoc executions

Filtering: - Filter by status (completed, failed, etc.) - Filter by time range (start_time, end_time)

Pagination: - Supports offset-based pagination via query parameters - Default limit: 20, max limit: 100 - Use ?page_size=X&page_number=Y for pagination

post/v1/retrievers/executions/list

Query parameters

limitinteger nullable

page_sizeinteger nullable

offsetinteger nullable

pageinteger nullable

cursorstring nullable

next_cursorstring nullable

afterstring nullable

include_totalboolean

Request body

statusstring nullable

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

{"stackTrail":"components:schemas:ListAdhocExecutionsRequest:properties:start_time:anyOf","oasType":"schema","type":"unknown","title":"Start Time","description":"Filter executions after this timestamp (inclusive). OPTIONAL - omit for no start time filter.","nullable":true}

{"stackTrail":"components:schemas:ListAdhocExecutionsRequest:properties:end_time:anyOf","oasType":"schema","type":"unknown","title":"End Time","description":"Filter executions before this timestamp (inclusive). OPTIONAL - omit for no end time filter.","nullable":true}

Example request

{
  "status": "completed"
}

Response

Successful Response

totalinteger

Total number of ad-hoc executions matching filters.

{"stackTrail":"components:schemas:ListAdhocExecutionsResponse:properties:pagination","oasType":"schema","type":"unknown","title":"Pagination","description":"Pagination metadata."}