> ## 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 publish queries with the Data API?

> Create versioned queries, publish definitions and inspect integration contracts.

Create versioned queries, publish definitions and inspect integration contracts.

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 saved queries](/docs/api-reference/data-queries/get-v2-metrics-queries) — `GET /api/v2/metrics/queries`
* [Create a query](/docs/api-reference/data-queries/post-v2-metrics-queries) — `POST /api/v2/metrics/queries`
* [Read query insights](/docs/api-reference/data-queries/get-v2-metrics-queries-query-id-insights) — `GET /api/v2/metrics/queries/{queryId}/insights`
* [Inspect the query integration contract](/docs/api-reference/data-queries/get-v2-metrics-queries-query-id-integration-contract) — `GET /api/v2/metrics/queries/{queryId}/integration-contract`
* [Execute a query for an integration](/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-integration-runs) — `POST /api/v2/metrics/queries/{queryId}/integration-runs`
* [Create a version of a query](/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-versions) — `POST /api/v2/metrics/queries/{queryId}/versions`
* [Publish a version of a query](/docs/api-reference/data-queries/post-v2-metrics-queries-query-id-versions-version-id-publish) — `POST /api/v2/metrics/queries/{queryId}/versions/{versionId}/publish`

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