Templates
Cluster Templates

List Cluster Templates

Changed on

List cluster templates (system + organization + user).

Supports filtering, sorting, and search like other list operations.

post/v1/templates/clusters

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/templates/clusters
  • Auth: HTTP bearer and API key in header X-Namespace

Request body

filtersobject nullable

Filters to apply when listing templates. Format: {"AND": [{"field": "field_name", "operator": "eq", "value": "value"}]}

sortobject nullable

Sort options for the results. Format: {'field': 'name', 'direction': 'asc'}

searchstring nullable

Search term for wildcard search across template_id, name, description, and tags

scope'system' | 'organization' | 'user' | 'public'

Scope of template availability.

system: Mixpeek-provided, available to all orgs organization: Private to org members user: Private to creator only public: User-created, discoverable by all orgs (marketplace)

categorystring nullable

Filter by category

is_activeboolean

Show only active templates

tagsstring[] nullable

Filter by tags (templates must have ALL specified tags)

Example request

{
  "category": "semantic_search",
  "is_active": true,
  "scope": "system",
  "search": "semantic"
}

Response

Successful Response

total_countinteger required

Total number of templates matching the query

Example response

{
  "results": [
    {
      "category": "semantic_search",
      "description": "Simple text-based semantic search",
      "internal_id": "system",
      "is_active": true,
      "is_public": true,
      "name": "Basic Semantic Search",
      "scope": "system",
      "template_id": "tmpl_semantic_search",
      "template_type": "retriever"
    }
  ],
  "total_count": 1
}

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 06a23e5a9062Revision changes
    • warning

      added the new manifest enum value to the // response property for the response status