> ## Documentation Index
> Fetch the complete documentation index at: https://chatobserver.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# How do I create and version reusable data definitions through the API?

> Manage reusable definitions and their immutable versions.

Manage reusable definitions and their immutable versions.

Read [authentication](/docs/developers/authentication), [pagination and filters](/docs/developers/pagination-and-filters), and [safe writes and retries](/docs/developers/safe-writes) before integrating. Each endpoint below includes its request parameters, response schema, and code examples.

## Endpoints

* [List analysis views](/docs/api-reference/data-definitions/get-v2-metrics-analysis-views) — `GET /api/v2/metrics/analysis-views`
* [Create an analysis view](/docs/api-reference/data-definitions/post-v2-metrics-analysis-views) — `POST /api/v2/metrics/analysis-views`
* [List query templates](/docs/api-reference/data-definitions/get-v2-metrics-templates) — `GET /api/v2/metrics/templates`
* [Get usage](/docs/api-reference/data-definitions/get-v2-metrics-usage) — `GET /api/v2/metrics/usage`
* [List reusable definitions](/docs/api-reference/data-definitions/get-v2-metrics-definitions-resource-type) — `GET /api/v2/metrics/definitions/{resourceType}`
* [Create a reusable definition](/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type) — `POST /api/v2/metrics/definitions/{resourceType}`
* [Create a version of a reusable definition](/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type-resource-id-versions) — `POST /api/v2/metrics/definitions/{resourceType}/{resourceId}/versions`
* [Publish a version of a reusable definition](/docs/api-reference/data-definitions/post-v2-metrics-definitions-resource-type-resource-id-versions-version-id-publish) — `POST /api/v2/metrics/definitions/{resourceType}/{resourceId}/versions/{versionId}/publish`

[Download the complete OpenAPI specification](/docs/openapi.json) for client generation and schema validation.