> For the complete documentation index, see [llms.txt](https://w3block.gitbook.io/w3block-eng/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://w3block.gitbook.io/w3block-eng/dev-docs/api/key-api-services/tokens/categories/subcategories.md).

# 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>
{% endopenapi %}

### Create a subcategory

{% openapi src="<https://api.pixway.io/docs-json>" path="/{companyId}/subcategories" method="post" %}
<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>
{% endopenapi %}

### Update subcategory

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