How do I create and publish queries with the Data API?

Create versioned queries, publish definitions and inspect integration contracts. Read authentication, pagination and filters, and safe writes and retries before integrating. Each endpoint below includes its request parameters, response schema, and code examples.

Endpoints

List saved queries — GET /api/v2/metrics/queries
Create a query — POST /api/v2/metrics/queries
Read query insights — GET /api/v2/metrics/queries/{queryId}/insights
Inspect the query integration contract — GET /api/v2/metrics/queries/{queryId}/integration-contract
Execute a query for an integration — POST /api/v2/metrics/queries/{queryId}/integration-runs
Create a version of a query — POST /api/v2/metrics/queries/{queryId}/versions
Publish a version of a query — POST /api/v2/metrics/queries/{queryId}/versions/{versionId}/publish

Download the complete OpenAPI specification for client generation and schema validation.

Integration guides

Endpoint reference

How do I create and publish queries with the Data API?

Endpoints

​Endpoints

Endpoints