> 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.md).

# Categories

Categories are essential to create your own Token. A token can be anything you want: a piece of art, a ticket for a show a certificate for your antiquity... Categories are here to separate token templates so it is easier to find them all, all templates created fall under a category.\
\
Our API already has a set of generic categories for you but if you want a new category can be created for an specific company.

### List Generic Categories

List all generic Categories

{% openapi src="<https://api.pixway.io/docs-json>" path="/categories" method="get" %}
<https://api.pixway.io/docs-json>
{% endopenapi %}

### Create a Category for your Company

If you want a category that is not listed on the generics you can create your own category for your Company

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

### List Categories by Company

List all Company Categories, this includes all categories you created plus all generic categories with a template that you created.

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

### Update a Company Category

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

### Get Category info

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