The Couchbase AI Data Plane API Change Log

  • reference

This page covers all changes for the Model Service API and the Couchbase Capella Management API. The Management API includes features for Capella Operational, Capella App Services, Operational Insights Capella, and AI Data Plane.

This change log lists:

Management API Change Log

Version 4.0.0

Initial release.

October 2026 Changes

Operation Details

Create AI Workflow

Use this operation to enable private networking for your AWS Bedrock model connected to your Workflow. For more information about Workflows, see Process Your Data For the Couchbase AI Data Plane.

List MCP Servers
Create MCP Server
Get MCP Server
Delete MCP Server
Get MCP Server Client Config

Added the MCP Servers API. This enables you to create and manage MCP servers that expose a Capella operational cluster to AI agents over the Model Context Protocol (MCP).

List MCP Tools

Added the MCP Tools API. This enables you to list the tools an MCP server can serve, grouped by tool group.

List Agent Memory Servers
Create Agent Memory Server
Get Agent Memory Server
Delete Agent Memory Server
Copy Agent Memory Server
Get Agent Memory Server Deployment Options
List Organization Agent Memory Servers
List Agent Memory Server Eligible Clusters

Added the AI Agent Memory Servers API. Use this API to deploy and manage Agent Memory servers for your Capella operational clusters. For more information about Agent Memory, see Agent Memory for Persistent Memory Storage.

List Agent Memory API Keys
Create Agent Memory API Key
Get Agent Memory API Key
Delete Agent Memory API Key
List Organization Agent Memory API Keys

Added the AI Agent Memory API Keys API. Use this API to create and manage the API keys that authenticate calls to the Agent Memory API. For more information about Agent Memory API keys, see Agent Memory API Keys.

List Agent Memory Server Allowed CIDRs
Create Agent Memory Server Allowed CIDR
Delete Agent Memory Server Allowed CIDR
List Organization Agent Memory Allowed CIDRs

Added the AI Agent Memory Allowed CIDRs API. Use this API to manage the IP addresses that can access your Agent Memory servers. For more information about allowed IP addresses, see Allowed IP Addresses.

August 2026 Changes

Operation Details

List Capella Privileges
List Database Roles
Create Database Role
Get Database Role
Update Database Role
Delete Database Role

Added the Database Roles API. Use this API to manage access roles for advanced access credentials. For more information about access roles, see Advanced Access Credentials. For more information about managing cluster access, see Manage Cluster Access Credentials.

June 2026 Changes

Operation Details

Get Eventing Function Code
Update Eventing Function Code
Get Eventing Function
Delete Eventing Function
Update Eventing Function
Create Eventing Function
List Eventing Functions
Set Eventing Function State
Get Function Logs

Added the Eventing Functions API. Use this API to run JavaScript code in response to data changes in a collection. For more information about Eventing Functions, see Run a Function on Data Change.

Create Alert Integration
List Alert Integrations
List Channels for an Alert Integration
Get Alert Integration
Update Alert Integration
Delete Alert Integration
Test Alert Integration

Updated the Alert Integration API to also support Slack and Microsoft Teams as third-party tools for alert integrations in Capella. For more information about alert integrations, see Alert Integrations.

Create AI Workflow
Get Supported External Embedding Models

The AI Workflows API now supports AWS Bedrock as an external embedding model provider.

May 2026 Changes

Operation Details

Update Deletion Protection

Use this operation to enable or disable deletion protection for a cluster. For example, when you enable deletion protection, you cannot delete your cluster, its App Services, and buckets, and you cannot flush bucket data.

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 the Couchbase AI Data Plane. 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.

List AI Workflows
Create AI Workflow
Get AI Workflow
Delete AI Workflow
List AI Workflow Runs
Run an AI Workflow
Stop AI Workflow Run
Get AI Workflow Run
Get AI Workflow Run Processed Files

Added the Workflows API. This enables you to vectorize structured or unstructured data stored in Capella operational clusters or in external files.

List Providers
Create provider
Get provider
Update provider
Delete provider

Added the Providers API. This enables you to use integrations with external services required by the AI Data Plane. Use these endpoints to help interactions with external services providers required by the AI Data Plane.

List Models
Create Model
Get Model
Delete Model
Get Model Connection String

Added the Models (AI Data Plane) API. This enables you to deploy and manage AI models. This includes open LLMs like Llama3 and embedding models.

Create Model API Key
List Model API keys
Get Model API Key
Delete Model API key

Added the Model Services API Keys (AI Data Plane) API. This enables you to create and manage API keys for your AI models, ensuring secure and controlled access models while you use them.

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.

Create Cloud Snapshot Backup
List Cloud Snapshot Backups
Update Backup Retention
Delete Backup
Restore Backup
List Cloud Snapshot Restores

Added the Operational Insights Cloud Snapshot Backups & Restore API. This enables you to perform on-demand backups of Operational Insights cloud snapshot data.

Upsert Backup Schedule
Get Backup Schedule
Delete Backup Schedule

Added the Operational Insights Cloud Snapshot Backups Schedule API. This enables you to schedule automatic backups of Operational Insights cloud snapshot data.

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.

Model Service API Change Log

Version 1.0.0

Initial release.

November 2025 Changes

Operation Details

Creates chat conversation

Added the Chat API to the Model Service API. This enables a model to start a conversation based on an input and generate an appropriate response.

Creates a completion

Added the Completions API to the Model Service API. This enables a model to receive a prompt and return 1 or more predicted completions. It can also return the probabilities of alternative tokens at each position.

Creates an embedding vector

Added the Embeddings API to the Model Service API. This enables a model to generate a vector representation of your input text in a format used by machine learning models and algorithms.

Creates and executes a batch
List your batches
Retrieves a batch
Cancels an in-progress batch

Added the Batch API to the Model Service API. This enables a model to create and execute a batch from an uploaded file of requests.

Upload a file that can used with a batch
Returns a list of files
Return information about a specific file
Deletes a file
Returns the contents of the specified file

Added the Files API to the Model Service API. This enables a model to receive and use uploaded documents to a model for features like Assistants and Fine-tuning.

Lists the currently available models
Retrieves a model instance details

Added the Models API to the Model Service API. This enables a model to list and describe the various models available in the API.

Classifies any potentially harmful text

Added the Moderations API to the Model Service API. This enables a model to classify any potentially harmful text in a given prompt.

See Also