# Categories

Category management operations. Categories represent the grouping or classification of content within a dataspace (taxonomy).

## Bind metadata query to a category

 - [PUT /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}/bindings/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/bindmetadataquerytocategory.md)

## Unbind metadata query from a category

 - [DELETE /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}/bindings/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/unbindmetadataqueryfromcategory.md)

## Create a new category

 - [POST /accounts/{accountId}/ontologies/{ontologyId}/categories](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/createcategory.md): Creates a new category within an ontology. The new category will initially have no bound metadata queries. Use the metadata query binding endpoints to associate metadata queries with this category.

## List all categories in an ontology

 - [GET /accounts/{accountId}/ontologies/{ontologyId}/categories](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/listcategories.md): Returns all categories with their bound metadata queries. Each metadata query includes binding properties that define how the key is used within the category (required status and unique index participation).

## Get a category by ID

 - [GET /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/getcategory.md): Returns a single category with its bound metadata queries. Each metadata query includes binding properties that specify whether the key is required and whether it participates in the unique index for this category.

## Update a category

 - [PUT /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/updatecategory.md): Updates category properties (name, description, additional instructions). This endpoint does not modify metadata query bindings. Use the metadata query binding endpoints to manage key associations.

## Delete a category

 - [DELETE /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/categories/deletecategory.md)

## Bind metadata query to a category

 - [PUT /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}/bindings/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/bindmetadataquerytocategory.md)

## Unbind metadata query from a category

 - [DELETE /accounts/{accountId}/ontologies/{ontologyId}/categories/{categoryId}/bindings/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/unbindmetadataqueryfromcategory.md)