Merge pull request #377 from joshrotenberg/feat/api-coverage-medium-priority-375

feat: Medium Priority API Coverage Improvements (Issue #375)

Author: joshrotenberg

CLAUDE.md

@@ -465,6 +465,52 @@ let vpc = handler.create_active_active(subscription_id, region_id, &request).awa
 - **Testing**: Mock all HTTP calls with `wiremock`, never make real API calls in tests
 - **Active-Active**: Use `_active_active` suffixed functions for CRDB operations
 
+## OpenAPI Specification Validation
+
+### Automated Validation Tests
+The `redis-cloud` crate includes automated tests that validate our implementation against the official OpenAPI specification:
+
+**Test File**: `crates/redis-cloud/tests/openapi_validation.rs`
+
+**What is Validated**:
+1. **Spec Integrity** - OpenAPI spec loads and has required sections
+2. **Endpoint Count** - Verify we have the expected number of endpoints
+3. **Schema Definitions** - Key response types exist in spec
+4. **Endpoint Categories** - All expected API categories are present
+5. **Response Type Coverage** - Core fields match spec definitions
+
+**Running Validation**:
+```bash
+cargo test --package redis-cloud --test openapi_validation
+```
+
+### OpenAPI Spec Location
+- **Local Copy**: `crates/redis-cloud/tests/fixtures/cloud_openapi.json`
+- **Official Source**: https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json
+
+### API Documentation Pattern
+All handler functions include OpenAPI references in their documentation:
+
+```rust
+/// Get cloud accounts
+///
+/// Gets a list of all configured cloud accounts.
+///
+/// # API Endpoint
+///
+/// `GET /cloud-accounts`
+///
+/// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `getCloudAccounts`
+pub async fn get_cloud_accounts(&self) -> Result<CloudAccounts> {
+    // ...
+}
+```
+
+This pattern:
+- Links to the official OpenAPI specification
+- References the specific operationId from the spec
+- Makes it easy to cross-reference implementation with API docs
+
 ## Testing Approach
 
 ### MANDATORY Testing Requirements

crates/redis-cloud/src/cloud_accounts.rs

@@ -24,6 +24,13 @@
 //! - **Provider Details**: Retrieve provider-specific account information
 //! - **Multi-cloud Support**: Manage accounts across different cloud providers
 //!
+//! # API Reference
+//!
+//! All operations in this module map to the Redis Cloud REST API's Cloud Accounts endpoints.
+//! For detailed API documentation, see the [Redis Cloud OpenAPI Specification].
+//!
+//! [Redis Cloud OpenAPI Specification]: https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json
+//!
 //! # Example Usage
 //!
 //! ```no_run
@@ -281,17 +288,27 @@ impl CloudAccountsHandler {
     }
 
     /// Get cloud accounts
+    ///
     /// Gets a list of all configured cloud accounts.
     ///
-    /// GET /cloud-accounts
+    /// # API Endpoint
+    ///
+    /// `GET /cloud-accounts`
+    ///
+    /// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `getCloudAccounts`
     pub async fn get_cloud_accounts(&self) -> Result<CloudAccounts> {
         self.client.get("/cloud-accounts").await
     }
 
     /// Create cloud account
+    ///
     /// Creates a cloud account.
     ///
-    /// POST /cloud-accounts
+    /// # API Endpoint
+    ///
+    /// `POST /cloud-accounts`
+    ///
+    /// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `createCloudAccount`
     pub async fn create_cloud_account(
         &self,
         request: &CloudAccountCreateRequest,
@@ -300,9 +317,14 @@ impl CloudAccountsHandler {
     }
 
     /// Delete cloud account
+    ///
     /// Deletes a cloud account.
     ///
-    /// DELETE /cloud-accounts/{cloudAccountId}
+    /// # API Endpoint
+    ///
+    /// `DELETE /cloud-accounts/{cloudAccountId}`
+    ///
+    /// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `deleteCloudAccount`
     pub async fn delete_cloud_account(&self, cloud_account_id: i32) -> Result<TaskStateUpdate> {
         let response = self
             .client
@@ -312,19 +334,29 @@ impl CloudAccountsHandler {
     }
 
     /// Get a single cloud account
+    ///
     /// Gets details on a single cloud account.
     ///
-    /// GET /cloud-accounts/{cloudAccountId}
+    /// # API Endpoint
+    ///
+    /// `GET /cloud-accounts/{cloudAccountId}`
+    ///
+    /// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `getCloudAccountById`
     pub async fn get_cloud_account_by_id(&self, cloud_account_id: i32) -> Result<CloudAccount> {
         self.client
             .get(&format!("/cloud-accounts/{}", cloud_account_id))
             .await
     }
 
     /// Update cloud account
+    ///
     /// Updates cloud account details.
     ///
-    /// PUT /cloud-accounts/{cloudAccountId}
+    /// # API Endpoint
+    ///
+    /// `PUT /cloud-accounts/{cloudAccountId}`
+    ///
+    /// See [OpenAPI Spec](https://redis.io/docs/latest/operate/rc/api/api-reference/openapi.json) - `updateCloudAccount`
     pub async fn update_cloud_account(
         &self,
         cloud_account_id: i32,