> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create Taxonomy Template > Create template from existing taxonomy. Supports three template scopes: - **organization**: Available to all users in your organization (default) - **user**: Available only to you - **system**: Available to all organizations (requires Mixpeek admin email) ## OpenAPI ````yaml post /v1/templates/taxonomies/from-taxonomy/{taxonomy_id} openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: [] paths: /v1/templates/taxonomies/from-taxonomy/{taxonomy_id}: post: tags: - Templates - Taxonomy Templates summary: Create Taxonomy Template description: >- Create template from existing taxonomy. Supports three template scopes: - **organization**: Available to all users in your organization (default) - **user**: Available only to you - **system**: Available to all organizations (requires Mixpeek admin email) operationId: >- create_taxonomy_template_v1_templates_taxonomies_from_taxonomy__taxonomy_id__post parameters: - name: taxonomy_id in: path required: true schema: type: string title: Taxonomy Id description: Taxonomy ID description: Taxonomy ID requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateTemplateFromResourceRequest' responses: '201': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CreateTemplateFromResourceResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: CreateTemplateFromResourceRequest: properties: template_name: type: string maxLength: 100 minLength: 1 title: Template Name description: Name for the new template description: anyOf: - type: string maxLength: 1000 - type: 'null' title: Description description: Description of the template's purpose (OPTIONAL) scope: $ref: '#/components/schemas/TemplateScope' description: >- Template scope: 'organization' (all users in org), 'user' (only you), or 'system' (all organizations - requires Mixpeek admin email) default: organization category: anyOf: - type: string maxLength: 50 - type: 'null' title: Category description: Optional category for organizing templates tags: items: type: string type: array title: Tags description: Optional tags for the template is_public: type: boolean title: Is Public description: Whether this template should be publicly discoverable default: false type: object required: - template_name title: CreateTemplateFromResourceRequest description: Request to create a template from an existing resource. examples: - category: ecommerce description: Semantic search optimized for product catalogs is_public: false tags: - products - search template_name: My Product Search Pattern CreateTemplateFromResourceResponse: properties: template_id: type: string title: Template Id description: ID of the created template template_name: type: string title: Template Name description: Name of the created template template_type: $ref: '#/components/schemas/TemplateType' description: Type of template created scope: $ref: '#/components/schemas/TemplateScope' description: Template scope source_resource_id: type: string title: Source Resource Id description: ID of the resource used to create this template created_at: type: string format: date-time title: Created At description: Timestamp when template was created type: object required: - template_id - template_name - template_type - scope - source_resource_id title: CreateTemplateFromResourceResponse description: Response after creating a template from a resource. examples: - created_at: '2025-01-15T12:00:00Z' scope: organization source_resource_id: ret_xyz789 template_id: tmpl_custom_abc123 template_name: My Product Search Pattern template_type: retriever ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError TemplateScope: type: string enum: - system - organization - user - public title: TemplateScope description: |- 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) TemplateType: type: string enum: - namespace - retriever - cluster - collection - bucket - taxonomy - scaffold title: TemplateType description: Types of resources that can be templated. ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ````