The live ClickHouse Cloud OpenAPI spec has operations or schemas that the
Rust library (client.rs / models.rs) does not cover yet.

• Live spec: https://api.clickhouse.cloud/v1
• Client: crates/clickhouse-cloud-api/src/client.rs
• Models: crates/clickhouse-cloud-api/src/models.rs
• Beta metadata: crates/clickhouse-cloud-api/src/meta.rs

Summary

Missing Model Types

The live spec defines these schemas but models.rs has no matching
pub struct, pub enum, or pub type.

CustomPrivateDnsMapping (spec name: CustomPrivateDnsMapping)

{
  "properties": {
    "privateDnsName": {
      "description": "Custom private DNS name managed by the DNS controller. No Route53 hosted zone is required.",
      "type": "string",
      "example": "my-service.example.com"
    }
  }
}

Missing Struct Fields

These properties exist in the OpenAPI spec but have no corresponding
field in the Rust struct. API response data for these fields is silently
dropped during deserialization.

Stale Snapshot

The committed clickhouse_cloud_openapi.json is behind the live spec.
Tests that run against the snapshot may pass even though the library is
missing coverage for new endpoints or schemas.

New schemas in live spec (not in snapshot):

• CustomPrivateDnsMapping

Implementation Guide

1. Update the checked-in spec:

   curl -s https://api.clickhouse.cloud/v1 -o crates/clickhouse-cloud-api/clickhouse_cloud_openapi.json

2. Add missing types to crates/clickhouse-cloud-api/src/models.rs
   • Use #[serde(rename_all = "camelCase")] on structs
   • Use #[serde(skip_serializing_if = "Option::is_none")] for optional fields
   • Enums should derive Default and include an #[serde(other)] Unknown variant
3. Add missing methods to crates/clickhouse-cloud-api/src/client.rs
4. Fix any field optionality mismatches by hand-editing models.rs
   (flip T ↔ Option<T> and the matching skip_serializing_if attribute).
5. Verify: cargo test -p clickhouse-cloud-api