Skip to main content
GET
/
v1
/
taxonomies
/
{taxonomy_id}
/
versions
List Taxonomy Versions
curl --request GET \
  --url https://api.mixpeek.com/v1/taxonomies/{taxonomy_id}/versions
{
  "results": [
    {
      "taxonomy_name": "<string>",
      "config": {
        "input_mappings": [
          {
            "input_key": "image_vector",
            "path": "features.clip_vit_l_14",
            "source_type": "vector"
          }
        ],
        "retriever_id": "ret_clip_v1",
        "source_collection": {
          "collection_id": "col_products_v1",
          "enrichment_fields": [
            {
              "field_path": "metadata.tags",
              "merge_mode": "append"
            }
          ]
        },
        "taxonomy_type": "flat"
      },
      "taxonomy_id": "<string>",
      "version": 1,
      "description": "<string>",
      "retriever_id": "<string>",
      "input_mappings": [
        {
          "input_key": "<string>",
          "source_type": "payload",
          "path": "<string>",
          "override": "<unknown>"
        }
      ],
      "ready": true,
      "created_at": "2023-11-07T05:31:56Z",
      "metadata": {}
    }
  ],
  "pagination": {},
  "total_count": 123,
  "stats": {
    "total_taxonomies": 0,
    "flat_taxonomies": 0,
    "hierarchical_taxonomies": 0,
    "taxonomies_with_retrievers": 0
  }
}

Headers

​
Authorization
string

REQUIRED: Bearer token authentication using your API key. Format: 'Bearer sk_xxxxxxxxxxxxx'. You can create API keys in the Mixpeek dashboard under Organization Settings.

Examples:

"Bearer YOUR_API_KEY"

"Bearer YOUR_STRIPE_API_KEY"

​
X-Namespace
string

REQUIRED: Namespace identifier for scoping this request. All resources (collections, buckets, taxonomies, etc.) are scoped to a namespace. You can provide either the namespace name or namespace ID. Format: ns_xxxxxxxxxxxxx (ID) or a custom name like 'my-namespace'

Examples:

"ns_abc123def456"

"production"

"my-namespace"

Path Parameters

​
taxonomy_id
string
required

Taxonomy ID (tax_...)

Response

Successful Response

Response model for listing taxonomies.

​
results
TaxonomyResponse · object[]
required
​
pagination
Pagination · object
required
​
total_count
integer
required
​
stats
TaxonomyListStats · object

Aggregate statistics across all taxonomies in the result