Skip to main content
POST
/
v1
/
templates
/
taxonomies
/
{template_id}
/
instantiate
Instantiate Taxonomy Template
curl --request POST \
  --url https://api.mixpeek.com/v1/templates/taxonomies/{template_id}/instantiate \
  --header 'Content-Type: application/json' \
  --data '
{
  "taxonomy_name": "<string>",
  "collection_config": {},
  "description": "<string>"
}
'
{
  "taxonomy_id": "<string>",
  "taxonomy_name": "<string>",
  "template_id": "<string>",
  "status": "created",
  "created_at": "2023-11-07T05:31:56Z"
}

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.

​
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'

Path Parameters

​
template_id
string
required

Template ID

Body

application/json

Request to instantiate a taxonomy from a template.

​
taxonomy_name
string
required

Name for the new taxonomy

Required string length: 1 - 100
​
collection_config
Collection Config · object
required

Collection configuration for the taxonomy. For flat taxonomies: {'collection_id': 'col_xxx'} For hierarchical taxonomies: maps node collection IDs to actual collection IDs, e.g., {'col_template_root': 'col_actual_root', 'col_template_child': 'col_actual_child'}

​
description
string | null

Optional description override for the taxonomy

Maximum string length: 1000

Response

Successful Response

Response after instantiating a taxonomy template.

​
taxonomy_id
string
required

ID of the created taxonomy

​
taxonomy_name
string
required

Name of the created taxonomy

​
template_id
string
required

ID of the template used

​
status
string
default:created

Status of the instantiation

​
created_at
string<date-time>

Timestamp when taxonomy was created