Discovery

List Available Retriever Stages with Examples

Changed on

Discover all available retriever stages with extended information including example configurations, common use cases, and cost tiers. This endpoint provides more context than /v1/retrievers/stages for agent-driven configuration.

get/v1/discovery/stages

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/discovery/stages
  • Auth: none required

Response

Successful Response

stage_idstring required

Unique identifier for the stage

descriptionstring required

Human-readable description of stage behavior

categorystring required

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

iconstring required

Lucide React icon identifier

parameter_schemaobject nullable

JSON Schema for stage parameters

example_configobject nullable

Example stage configuration

common_use_casesstring[]

Common scenarios where this stage is useful

cost_tierstring

Relative cost tier: cheap, moderate, expensive

requires_collectionsboolean

Whether this stage requires collection access

Example response

[
  {
    "category": "filter",
    "common_use_cases": [
      "Semantic search over embeddings",
      "Multi-modal retrieval",
      "Hybrid search with fusion"
    ],
    "cost_tier": "moderate",
    "description": "Unified multi-vector search with N feature URIs and fusion",
    "example_config": {
      "parameters": {
        "feature_uri": "multimodal_extractor.v1.embedding",
        "query": "{{ INPUT.query }}",
        "top_k": 25
      },
      "stage_id": "feature_filter",
      "stage_name": "semantic_search"
    },
    "icon": "search",
    "parameter_schema": {
      "properties": {
        "feature_uri": {
          "type": "string"
        },
        "top_k": {
          "default": 25,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "requires_collections": true,
    "stage_id": "feature_filter"
  }
]

Changes

  • 61a175e8eb9aRevision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status