api section

Author: kaitlynmichael

content/operate/kubernetes/reference/api/_index.md

@@ -0,0 +1,56 @@
+---
+title: API reference
+categories:
+- docs
+- operate
+- kubernetes
+linkTitle: API reference
+description: Reference documentation for Redis Enterprise operator APIs
+weight: 30
+alwaysopen: false
+hideListLinks: true
+aliases:
+---
+
+The Redis Enterprise operator provides Kubernetes custom resource definitions (CRDs) that allow you to manage Redis Enterprise clusters and databases declaratively. This section contains the complete API reference for all operator resources.
+
+## API versions and stability
+
+The operator uses different API versions to indicate stability and feature maturity:
+
+- **`app.redislabs.com/v1`** - Stable APIs for production use
+- **`app.redislabs.com/v1alpha1`** - Alpha APIs that may change in future releases
+
+## Custom resources
+
+| Resource | API Version | Purpose |
+|----------|-------------|---------|
+| [RedisEnterpriseCluster (REC)](redis_enterprise_cluster_api) | `v1` | Manages Redis Enterprise cluster deployments |
+| [RedisEnterpriseDatabase (REDB)](redis_enterprise_database_api) | `v1alpha1` | Creates and configures Redis databases |
+| [RedisEnterpriseActiveActiveDatabase (REAADB)](redis_enterprise_active_active_database_api) | `v1alpha1` | Sets up active-active databases across clusters |
+| [RedisEnterpriseRemoteCluster (RERC)](redis_enterprise_remote_cluster_api) | `v1alpha1` | Defines remote cluster connections for active-active |
+
+## Working with the APIs
+
+### Using kubectl
+
+All resources can be managed using standard `kubectl` commands:
+
+```bash
+# List all Redis Enterprise clusters
+kubectl get rec
+
+# Get detailed information about a specific database
+kubectl describe redb my-database
+
+# Apply a configuration from a YAML file
+kubectl apply -f my-redis-config.yaml
+```
+
+### Resource relationships
+
+- A `RedisEnterpriseCluster` (REC) must be created first to provide the Redis Enterprise infrastructure
+- `RedisEnterpriseDatabase` (REDB) resources are created within a cluster to provision individual databases
+- `RedisEnterpriseActiveActiveDatabase` (REAADB) requires `RedisEnterpriseRemoteCluster (RERC)` resources to define participating clusters
+
+For complete YAML configuration examples, see the [YAML examples](../yaml/) section.

content/operate/kubernetes/reference/kubernetes-api-reference-frontmatter.patch renamed to content/operate/kubernetes/reference/api/kubernetes-api-reference-frontmatter.patch

@@ -7,7 +7,7 @@ categories:
 - kubernetes
 description: Support matrix for the current Redis Enterprise K8s operator
 linkTitle: Supported distributions
-weight: 30
+weight: 10
 ---
 
 Each release of Redis Enterprise for Kubernetes is thoroughly tested against a set of Kubernetes distributions. The table below lists Redis Enterprise for Kubernetes versions and the Kubernetes distributions they support.