---
description: This module can be used to create and list subcategories (token templates)
---

# Subcategories

Token Templates are the barebones of any token collection, when you create a collection you select a category for it and then a template, this contains a set of pre-defined parameters that any one of your tokens will need in its metadata.

### List all subcategories

When listing subcategories you have three scope options:

* **generic:** brings subcategories that are generic and are not for a specific company
* **specific:** lists only subcategories created by the company
* **all:** lists all of the above

{% openapi src="https://api.pixway.io/docs-json" path="/{companyId}/subcategories" method="get" %}
[https://api.pixway.io/docs-json](https://api.pixway.io/docs-json)
{% endopenapi %}

### Create a subcategory

{% openapi src="https://api.pixway.io/docs-json" path="/{companyId}/subcategories" method="post" %}
[https://api.pixway.io/docs-json](https://api.pixway.io/docs-json)
{% endopenapi %}

### Get subcategory details

{% openapi src="https://api.pixway.io/docs-json" path="/{companyId}/subcategories/{id}" method="get" %}
[https://api.pixway.io/docs-json](https://api.pixway.io/docs-json)
{% endopenapi %}

### Update subcategory

{% openapi src="https://api.pixway.io/docs-json" path="/{companyId}/subcategories/{id}" method="patch" %}
[https://api.pixway.io/docs-json](https://api.pixway.io/docs-json)
{% endopenapi %}
