v10

latestOpenAPI 3.1.02026-08-085671,1112.8 MB

Discovery

List Available Retriever Stages with Examples

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

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"
  }
]