# Metadata Queries

Metadata key management operations. Metadata keys define specific metadata fields that can be associated with content and bound to categories.

## 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 metadata query

 - [POST /accounts/{accountId}/ontologies/{ontologyId}/metadata-queries](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/createmetadataquery.md)

## List all metadata queries in an ontology

 - [GET /accounts/{accountId}/ontologies/{ontologyId}/metadata-queries](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/listmetadataqueries.md): Returns all metadata queries with their category bindings including binding properties (required, uniqueIndexElement)

## Get a metadata query by ID

 - [GET /accounts/{accountId}/ontologies/{ontologyId}/metadata-queries/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/getmetadataquery.md): Returns a single metadata query with its category bindings including binding properties (required, uniqueIndexElement)

## Update a metadata query

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

## Delete a metadata query

 - [DELETE /accounts/{accountId}/ontologies/{ontologyId}/metadata-queries/{metadataQueryId}](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/deletemetadataquery.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)

## Get metadata query usage count

 - [GET /accounts/{accountId}/ontologies/{ontologyId}/metadata-queries/{metadataQueryId}/usage-count](https://docs.syncdocs.ai/api/sync-cloud-openapi/metadata-queries/getmetadataqueryusagecount.md): Returns the number of categories that currently use this metadata query.
Features: - Efficient counting using SQL COUNT queries with JOIN - Returns exact count of categories bound to the metadata query - Useful for impact analysis before metadata query changes - Supports ontology change management workflows
Use Cases: - Determine impact before deleting a metadata query - Analyze metadata query usage across categories - Support ontology change management decisions - Dashboard statistics for metadata query utilization
Example Usage: - GET /accounts/acc-12345678/ontologies/ont-87654321/metadata-queries/123e4567-e89b-12d3-a456-426614174000/usage-count
Response: Returns a simple count object indicating how many categories are currently bound to this metadata query.
Performance: - Optimized for large ontologies using database indexes - Uses SQL COUNT with JOIN for efficient counting - Returns exact counts without loading category data into memory