# Confluent Version 2 API

**Canonical:** https://apis.io/apis/confluent/confluent-version-2-api/  
**Provider:** Confluent — https://apis.io/providers/confluent/  
**Base URL:** https://api.confluent.cloud  
**Documentation:** https://www.confluent.io/

Confluent Version 2 API is one of 127 APIs that [Confluent](https://apis.io/providers/confluent/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Version 2. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

![generally-available](https://img.shields.io/badge/Lifecycle%20Stage-Generally%20Available-%230074A2) Version 2 of the Metrics API adds the ability to query metrics for Kafka Connect, ksqlDB, and Schema Registry. This capability is enabled by the introduction of a [Resource](#section/Object-Model/Resources) abstraction into the API object model. Resources represent the entity against which metrics are collected. ### Migration Guide The following endpoint URLs have changed in version 2: | Endpoint | Version 1 (Sunset) | Version 2 | | ----------------------- | -------------------------------- | ---------------------------------------- | | Metrics discovery | `/metrics/{dataset}/descriptors` | `/metrics/{dataset}/descriptors/metrics` | The label prefix syntax has changed in version 2: | Label | Version 1 (Sunset) | Version 2 | | ----------------------- | ---------------------------- | ----------------------- | | Resource labels *(new)* | *N/A* | `resource.<label>` | | Kafka cluster ID | `metric.label.cluster_id` | `resource.kafka.id` | | All other metric labels | `metric.label.<label>` | `metric.<label>` | This example shows a request to `/v1/metrics/cloud/query` migrated into the new `v2` syntax #### Version 1 Request ```json { "group_by": [ "metric.label.topic" ], "aggregations": [{ "metric": "io.confluent.kafka.server/received_bytes", "agg": "SUM" }], "filter": { "field": "metric.label.cluster_id", "op": "EQ", "value": "lkc-00000" }, "granularity": "ALL", "intervals" : [ "2020-01-01T00:00:00Z/PT1H" ] } ``` #### Version 2 Request ```json { "group_by": [ "metric.topic" ], "aggregations": [{ "metric": "io.confluent.kafka.server/received_bytes", "agg": "SUM" }], "filter": { "field": "resource.kafka.id", "op": "EQ", "value": "lkc-00000" }, "granularity": "ALL", "intervals" : [ "2020-01-01T00:00:00Z/PT1H" ] } ```

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/confluent/refs/heads/main/openapi/confluent-version-2-api-openapi.yml
- **APIReference** — https://docs.confluent.io/cloud/current/api.html
- **APIReference** — https://api.telemetry.confluent.cloud/docs

## Other Confluent APIs (12)

- [Confluent](https://apis.io/apis/confluent/confluent/)
- [Confluent Managed MCP Servers](https://apis.io/apis/confluent/confluent-mcp/)
- [Confluent ACLs API](https://apis.io/apis/confluent/confluent-acls-api/)
- [Confluent API Keys API](https://apis.io/apis/confluent/confluent-api-keys-api/)
- [Confluent Clusters API](https://apis.io/apis/confluent/confluent-clusters-api/)
- [Confluent Consumer Groups API](https://apis.io/apis/confluent/confluent-consumer-groups-api/)
- [Confluent Environments API](https://apis.io/apis/confluent/confluent-environments-api/)
- [Confluent Partitions API](https://apis.io/apis/confluent/confluent-partitions-api/)
- [Confluent Service Accounts API](https://apis.io/apis/confluent/confluent-service-accounts-api/)
- [Confluent Topics API](https://apis.io/apis/confluent/confluent-topics-api/)
- [Confluent Access Points (networking/v1) API](https://apis.io/apis/confluent/confluent-access-points-networking-v1-api/)
- [Confluent ACL (v3) API](https://apis.io/apis/confluent/confluent-acl-v3-api/)

## Tags

Version 2

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/confluent/confluent-version-2-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/confluent/.