Skip to main content
POST
/
v1
/
templates
/
taxonomies
/
from-taxonomy
/
{taxonomy_id}
Create Taxonomy Template
curl --request POST \
  --url https://api.mixpeek.com/v1/templates/taxonomies/from-taxonomy/{taxonomy_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "template_name": "<string>",
  "description": "<string>",
  "scope": "organization",
  "category": "<string>",
  "tags": [
    "<string>"
  ],
  "is_public": false
}
'
{
  "template_id": "<string>",
  "template_name": "<string>",
  "source_resource_id": "<string>",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
taxonomy_id
string
required

Taxonomy ID

Body

application/json

Request to create a template from an existing resource.

​
template_name
string
required

Name for the new template

Required string length: 1 - 100
​
description
string | null

Description of the template's purpose (OPTIONAL)

Maximum string length: 1000
​
scope
enum<string>
default:organization

Template scope: 'organization' (all users in org), 'user' (only you), or 'system' (all organizations - requires Mixpeek admin email)

Available options:
system,
organization,
user,
public
​
category
string | null

Optional category for organizing templates

Maximum string length: 50
​
tags
string[]

Optional tags for the template

​
is_public
boolean
default:false

Whether this template should be publicly discoverable

Response

Successful Response

Response after creating a template from a resource.

​
template_id
string
required

ID of the created template

​
template_name
string
required

Name of the created template

​
template_type
enum<string>
required

Type of template created

Available options:
namespace,
retriever,
cluster,
collection,
bucket,
taxonomy,
scaffold
​
scope
enum<string>
required

Template scope

Available options:
system,
organization,
user,
public
​
source_resource_id
string
required

ID of the resource used to create this template

​
created_at
string<date-time>

Timestamp when template was created