Capella Operational Management API Change Log

  • Capella Operational

    This page is for Capella operational. For Capella AI Services, see Capella AI Services API Change Log. For Capella Analytics, see Capella Analytics Management API Change Log.

    Version 4.0.0

    Initial release.

    May 2026 Changes

    Operation Details

    Get Categorized Billing
    Get Itemized Billing Per Cluster
    Get Prepaid Credits Billing
    Get Pay As You Go Billing
    Download Categorized Billing
    Download Itemized Billing

    Added the Billing API. Use this API to retrieve billing information for your organization, clusters, App Services, and AI Services. You can view usage data by date range and filter it by category, project, or instance.

    The Get Itemized Billing Per Cluster and Download Itemized Billing endpoints support operational clusters only.

    April 2026 Changes

    Operation Details

    Get Cluster Capacity Statistics

    Use this operation to get cluster-level capacity statistics. For example, you can retrieve memory availability, replica limits, and other capacity metrics.

    February 2026 Changes

    Operation Details

    Update Organization Configuration

    Use this operation to add, update, and delete network subdomains for clusters deployed on any cloud service provider (CSP). This operation is only available upon request. For more information, contact Couchbase Capella Support.

    Resume App Service Log Streaming
    Pause App Service Log Streaming
    Configure App Service Log Streaming
    Get App Service Log Streaming Configuration and State
    Disable App Service Log Streaming
    Update App Endpoint Log Streaming Config
    Get App Endpoint Log Streaming Config

    Added the App Services Log Streaming API. Use this API to stream App Services operational logs to third-party observability platforms or self-hosted HTTP log collectors. For more information, see Manage Log Streaming with the Management API.

    Get Azure Application ID For Project
    Create Azure Key Metadata For Project
    List Azure Key Metadata For Project
    Get Azure Key Metadata For Project
    Rotate Azure Key For Project
    Delete Azure Key Metadata For Project
    Enable Azure CMEK For Project

    Added project level endpoints to the CMEK API. Use these operations to manage CMEK at the project level. For more information, see Use Customer-Managed Encryption Keys (CMEK).

    Get Cluster On/Off Schedule
    Pause Cluster On/Off Schedule
    Unpause Cluster On/Off Schedule

    Added endpoints to the On/Off Schedule API. Use these operations to pause and unpause your cluster’s on/off schedule.

    Get Private Endpoint Service Status

    You can now use this operation to verify the status of XDCR and Prometheus metrics on your private endpoint.

    Enable Private Endpoint Service

    You can now use this operation to enable XDCR and Prometheus metrics when you enable the private endpoint service on your cluster.

    Update Private Endpoint Service Configuration

    Use this operation to enable or disable XDCR and Prometheus metrics access on an already enabled private endpoint service.

    December 2025 Changes

    Operation Details

    Get Azure Application ID

    Use this operation to get your application ID from Capella. Create a new service principal in your Azure tenant using this application ID to use CMEK on your Azure operational clusters. For more information, see Enable Customer-Managed Encryption Keys on Capella.

    Enable CMEK For Cloud Services Provider

    Use this operation to enable customer-managed encryption keys for the specified cloud service provider within your organization. For more information, see Enable Customer-Managed Encryption Keys on Capella.

    Create Key Metadata
    List Key Metadata
    Get Key Metadata
    Rotate Key

    These operations have been updated to support the keyLocation field required in an AzureConfig, to use CMEK on Azure operational clusters.

    November 2025 Changes

    Operation Details

    Create a new replication

    You can now choose between async and sync mode when creating a replication. The default mode is async.

    Get replication job details

    Use this operation to get the status of the asynchronous creation of the replication. It provides full details on the replication job after the job completes.

    Configure App Service Audit Log Streaming

    You can now choose dynatrace as a provider for audit log streaming.

    Create App Endpoint OpenID Connect (OIDC) Provider
    Update App Endpoint OpenID Connect (OIDC) Provider

    You can now include a scope field to define the scopes used in your OpenID Connect (OIDC) request. The default scopes are openid and email.

    October 2025 Changes

    Operation Details

    Update Data API
    Get Data API Status
    Get Data API Private Endpoints Command
    List Data API Private Endpoints
    Accept Data API Private Endpoint Connection
    Disassociate Data API Private Endpoint

    Added Data API endpoints to the Management API. These enable you to enable or disable the Data API, to configure the Data API for use over VPC peering or a private endpoint, and to get the base URL for connecting to the Data API. For more information, see Manage Data with the Data API.

    September 2025 Changes

    Operation Details

    Get replication details
    Delete a replication
    Update an existing replication
    List replications for a given cluster
    Create a new replication
    List replications for a given project
    Pause a replication
    Resume a replication

    Added the XDCR API. This enables you to create a replication between 2 Capella operational clusters, or between a Capella operational cluster and a self-managed cluster.

    List Available Geographic Regions for Cross-region Operations

    This enables you to list the geographic regions where replicas of the original backups can be stored.

    July 2025 Changes

    Operation Details

    Enable App Service Private Endpoints
    Get App Service Private Endpoints State
    Get App Service Private Endpoints Command
    List App Service Private Endpoints
    Accept Private Endpoint Request
    Delete Private Endpoint Request
    Disable App Service Private Endpoints

    Added the App Services Private Endpoints API. This enables you to connect to App Services over a secure private endpoint. Initially only available using Amazon Web Services (AWS). For details, see Private Endpoints for App Services.

    June 2025 Changes

    Operation Details

    List Cloud Snapshot Backups at the Project Level

    This enables you to list the cluster (cloud snapshot) backups associated with operational clusters within a specific project.

    Clone Cluster Backup

    This enables you to clone and restore a cluster (cloud snapshot) backup from one cluster to another new cluster.

    Delete Cluster

    The retain snapshot backups parameter is available in the Delete Cluster endpoint. This parameter specifies whether you want to retain cluster (cloud snapshot) backups after cluster deletion.

    May 2025 Changes

    Operation Details

    Delete App Service Allowed CIDR
    List Allowed CIDRs for an App Service
    Create Allowed CIDR

    Added the Allowed CIDRs (App Services) API. This enables you to manage the trusted IP addresses for your App Service.

    List App Endpoint Collections

    This enables you to list all the collections under a specific App Endpoint.

    Get the App Endpoint CORS Configuration
    Upsert the App Endpoint CORS Configuration

    These enable you to manage the Cross-Origin Resource Sharing (CORS) configuration of a specific App Endpoint.

    Create App Endpoint OIDC Provider
    List App Endpoint OIDC Providers
    Get App Endpoint OIDC Providers
    Update App Endpoint OIDC Providers
    Delete App Endpoint OIDC Providers
    Update App Endpoint Default OIDC Provider

    These enable you to manage the OpenID Connect (OIDC) provider for a specific App Endpoint.

    Get Public Certificate for App Service

    This enables you to retrieve your App Service’s public certificate. You can copy or download the endpoint’s SSL public certificate to bundle into your mobile application.

    Create App Service Admin User
    List App Service Admin Users
    Update App Service Admin User
    Delete App Service Admin User
    Get App Service Admin User
    List App Endpoints Admin Users

    These enable you to manage users with an admin credential specific to a particular App Service or App Endpoint.

    November 2024 Changes

    Operation Details

    Manage Query Indexes
    Get List of Index Definitions
    Get Index Definition
    Get Index Build Status

    Added the GSI API. This enables you to manage and monitor GSI indexes on the Couchbase Capella cluster.

    September 2024 Changes

    Operation Details

    Flush Bucket Data

    This enables you to delete all of the data presently stored in a bucket.

    Create Bucket

    The flush field is now deprecated and the flushEnabled field is available in the Create Bucket endpoint.

    Enable or Disable App Service Audit Logging
    Get App Service Audit Log State
    List App Endpoint Audit Log Event IDs
    Update App Endpoint Audit Logging Config
    Get App Endpoint Audit Logging Config
    Configure App Service Audit Log Streaming
    Start or Resume Audit Log Streaming
    Get App Service Audit Log Streaming State
    Initiate Audit Log Export
    List Audit Log Export Jobs
    Get Audit Log Export Job

    Added the App Services Audit Logging API. This enables you to configure and retrieve audit logs for App Services. For details, see Audit Logging.

    Create Cluster

    The enablePrivateDNSResolution field in the Create Cluster endpoint is conditionally available. The option to create a cluster with restricted public access is available only on request. For more information, contact Couchbase Support.

    List Key Rotation History

    This enables you to retrieve a list with the complete history of rotations for a specific customer-managed encryption key within the organization.

    Create Network Peering
    List Network Peering Records
    Get Network Peering record
    Get Azure VNET Peering CLI Command

    Added the Network Peering API for Azure. This enables you to configure a secure private network connection from Couchbase Capella clusters hosted with Azure to your application’s VPC.

    August 2024 Changes

    Operation Details

    Get Private Endpoint Service Status
    Enable Private Endpoint Service
    Disable Private Endpoint Service
    List Private Endpoints
    Get Private Endpoint CLI Command
    Accept Private Endpoint Request
    Reject or disassociate Private Endpoint

    Added the Private Endpoint Service API. This enables you to access your Capella cluster from your cloud provider’s private network.

    July 2024 Changes

    Operation Details

    Create Cluster

    The configurationType field in the Create Cluster endpoint is now deprecated.

    List Events
    Get Event
    List Events
    Get Project Event

    Added the System Events API. This enables you to retrieve the sequence of events and actions performed by users within the Capella environment. This is available at an organization and project level.

    June 2024 Changes

    Operation Details

    Create Network Peering
    List Network Peering Records
    Get Network Peering record
    Delete Network Peering

    Added the Network Peering API for AWS and GCP. This enables you to configure a secure private network connection from Couchbase Capella clusters hosted with AWS and GCP to your application’s VPC.

    May 2024 Changes

    Operation Details

    Create Cluster Audit Log Export job

    The Create Cluster Audit Log job API now supports the following RBAC roles: Cluster Viewer, Data Writer, and Data Reader.

    Migrate Buckets

    Added the Migrate Buckets API. For clusters using Couchbase Server 7.6 or later, this enables you to migrate from Couchstore to Magma storage engines.

    Update Organization Configuration

    Organization owners can now add, update, and delete custom subdomains for AWS clusters. Reach out to Couchbase support to enable this feature.

    Update Username

    Temporarily removed the operation to update a user name.

    April 2024 Changes

    Operation Details

    Update Cluster Audit Log Configuration
    Get Cluster Audit Log Configuration
    List Filterable Audit Log Events
    Create Cluster Audit Log Export Job
    List Cluster Audit Log Export Jobs
    Get Cluster Audit Log Export

    Added the Audit Log API. This enables you to configure auditing on your Capella cluster, and export audit logs to an AWS S3 bucket.

    March 2024 Changes

    Operation Details

    Update Collection
    Create Alert Integration
    List Alert Integrations
    Get Alert Integration
    Update Alert Integration
    Delete Alert Integration
    Test Alert Integration

    Added the Alert Integration API. This enables you to send Capella alert notifications to common services, such as ServiceNow.

    February 2024 Changes

    Operation Details

    Create Cluster On/Off schedule
    Get Cluster On/Off schedule
    Update Cluster On/Off schedule
    Delete Cluster On/Off schedule

    You can schedule when your provisioned cluster turns on or off to save costs. Turning off your cluster turns off the compute for your cluster, but the storage remains.

    Create Cluster
    List Clusters
    Get Cluster
    Update Cluster

    For clusters deployed on Microsoft Azure, you can now enable disk auto-expansion for each Service Group in the cluster. When enabled, the disk storage for each node in the Service Group automatically expands if needed.

    January 2024 Changes

    Operation Details

    Create Key Metadata
    List Key Metadata
    Get Key Metadata
    Rotate Key
    Delete Key Metadata
    Associate Key with Cluster
    Disassociate Key from Cluster

    Added the Customer Managed Encryption Keys API. This enables you to manage encryption keys.

    Get Scope
    Delete Scope
    List Scopes
    Create Scope
    Get Collection
    Delete Collection
    List Collections
    Create Collection

    Added Scopes and Collections operations to the Buckets API. These enable you to manage scopes and collections.

    In addition, to reflect this change, the Buckets API has been renamed as the Buckets, Scopes and Collections API.

    Load Sample Data
    List Sample Data Import Buckets
    Get Sample Import Bucket
    Delete Sample Import Bucket

    Added the Import Sample Dataset API. This enables you to import Couchbase sample data sets into the Capella cluster: travel-sample, beer-sample, and so on. You can also list sample data sets, get details of a sample data set, or delete a sample data set.

    December 2023 Changes

    Operation Details

    Update Username

    Organization owners can now update user names for any user in the organization.

    October 2023 Changes

    Operation Details

    Create Cluster

    The CIDR block for the cloud provider is no longer required when creating a cluster. If you do not provide a CIDR block when creating a cluster, a valid unused CIDR block is generated automatically.

    Get Cluster

    Getting details of a cluster now returns the connection string — the cluster endpoint for the client connection.

    Create Cluster Credentials

    Documentation for the request body now describes restrictions on the cluster credential name and the associated password.

    Update Project
    Update Cluster
    Update App Service Specs

    Clarified examples to show that the If-Match request header should not include a custom prefix, but must match the ETag returned by the GET operation.

    Update User

    Corrected responses to show that the ETag is not returned for this operation.

    List API Keys
    List Projects
    List Clusters
    List Users
    List Allowed CIDRs
    List Cluster Credentials
    List App Services

    Documentation now lists valid values for the sortBy field for each endpoint.

    See Also