Skip to main content
GET
/
v1
/
discovery
/
stages
List Available Retriever Stages with Examples
curl --request GET \
  --url https://api.mixpeek.com/v1/discovery/stages \
  --header 'Authorization: Bearer <token>'
[
  {
    "stage_id": "<string>",
    "description": "<string>",
    "category": "<string>",
    "icon": "<string>",
    "parameter_schema": {},
    "example_config": {},
    "common_use_cases": [
      "<string>"
    ],
    "cost_tier": "moderate",
    "requires_collections": true
  }
]

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successful Response

​
stage_id
string
required

Unique identifier for the stage

​
description
string
required

Human-readable description of stage behavior

​
category
string
required

Transformation category: filter, sort, reduce, apply, enrich

​
icon
string
required

Lucide React icon identifier

​
parameter_schema
Parameter Schema · object

JSON Schema for stage parameters

​
example_config
Example Config · object

Example stage configuration

​
common_use_cases
string[]

Common scenarios where this stage is useful

​
cost_tier
string
default:moderate

Relative cost tier: cheap, moderate, expensive

​
requires_collections
boolean
default:true

Whether this stage requires collection access