diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/cosmos-db.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/cosmos-db.json
index f524e9b3820c..394969ccd932 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/cosmos-db.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/cosmos-db.json
@@ -8560,6 +8560,16 @@
           "type": "object",
           "$ref": "#/definitions/Capacity"
         },
+        "capacityMode": {
+          "description": "Indicates the capacityMode of the Cosmos DB account.",
+          "type": "string",
+          "$ref": "#/definitions/CapacityMode"
+        },
+        "capacityModeChangeTransitionState": {
+          "description": "The object that represents the migration state for the CapacityMode of the Cosmos DB account.",
+          "type": "object",
+          "$ref": "#/definitions/CapacityModeChangeTransitionState"
+        },
         "enableMaterializedViews": {
           "description": "Flag to indicate whether to enable MaterializedViews on the Cosmos DB account",
           "type": "boolean"
@@ -8740,6 +8750,11 @@
           "type": "object",
           "$ref": "#/definitions/Capacity"
         },
+        "capacityMode": {
+          "description": "Indicates the capacityMode of the Cosmos DB account.",
+          "type": "string",
+          "$ref": "#/definitions/CapacityMode"
+        },
         "enableMaterializedViews": {
           "description": "Flag to indicate whether to enable MaterializedViews on the Cosmos DB account",
           "type": "boolean"
@@ -8944,6 +8959,11 @@
           "type": "object",
           "$ref": "#/definitions/Capacity"
         },
+        "capacityMode": {
+          "description": "Indicates the capacityMode of the Cosmos DB account.",
+          "type": "string",
+          "$ref": "#/definitions/CapacityMode"
+        },
         "enableMaterializedViews": {
           "description": "Flag to indicate whether to enable MaterializedViews on the Cosmos DB account",
           "type": "boolean"
@@ -10904,6 +10924,84 @@
         }
       }
     },
+    "CapacityMode": {
+      "description": "Indicates the capacity mode of the account.",
+      "type": "string",
+      "enum": [
+        "None",
+        "Provisioned",
+        "Serverless"
+      ],
+      "x-ms-enum": {
+        "name": "CapacityMode",
+        "modelAsString": true
+      }
+    },
+    "CapacityModeChangeTransitionState": {
+      "description": "The transition state information related capacity mode change with update request.",
+      "type": "object",
+      "properties": {
+        "capacityModeTransitionStatus": {
+          "type": "string",
+          "description": "The transition status of capacity mode.",
+          "enum": [
+            "Invalid",
+            "Initialized",
+            "InProgress",
+            "Completed",
+            "Failed"
+          ],
+          "x-ms-enum": {
+            "name": "CapacityModeTransitionStatus",
+            "modelAsString": true
+          }
+        },
+        "currentCapacityMode": {
+          "description": "Indicates the current capacity mode of the account.",
+          "type": "string",
+          "enum": [
+            "None",
+            "Provisioned",
+            "Serverless"
+          ],
+          "x-ms-enum": {
+            "name": "CapacityMode",
+            "modelAsString": true
+          }
+        },
+        "previousCapacityMode": {
+          "description": "Indicates the previous capacity mode of the account before successful transition.",
+          "type": "string",
+          "enum": [
+            "None",
+            "Provisioned",
+            "Serverless"
+          ],
+          "x-ms-enum": {
+            "name": "CapacityMode",
+            "modelAsString": true
+          }
+        },
+        "capacityModeTransitionBeginTimestamp": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "Begin time in UTC of the capacity mode change."
+        },
+        "capacityModeTransitionEndTimestamp": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "End time in UTC of the capacity mode change."
+        },
+        "capacityModeLastSuccessfulTransitionEndTimestamp": {
+          "readOnly": true,
+          "type": "string",
+          "format": "date-time",
+          "description": "End time in UTC of the last successful capacity mode change."
+        }
+      }
+    },
     "Tags": {
       "type": "object",
       "additionalProperties": {
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMax.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMax.json
index 1f211ff683ce..9da9c5350e9d 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMax.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMax.json
@@ -80,6 +80,7 @@
         "capacity": {
           "totalThroughputLimit": 2000
         },
+        "capacityMode": "Provisioned",
         "enableMaterializedViews": false,
         "enableBurstCapacity": true,
         "minimalTlsVersion": "Tls12",
@@ -218,6 +219,7 @@
           "capacity": {
             "totalThroughputLimit": 2000
           },
+          "capacityMode": "Provisioned",
           "enableMaterializedViews": false,
           "enableBurstCapacity": true,
           "minimalTlsVersion": "Tls12",
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMin.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMin.json
index bc205cbce8d2..bb4faa67a4ab 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMin.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountCreateMin.json
@@ -89,6 +89,7 @@
               "backupStorageRedundancy": "Geo"
             }
           },
+          "capacityMode": "Provisioned",
           "enableMaterializedViews": false,
           "minimalTlsVersion": "Tls",
           "keysMetadata": {
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountGet.json
index 2b25a59fc2c9..5a0efd488f06 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountGet.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountGet.json
@@ -106,6 +106,15 @@
           "diagnosticLogSettings": {
             "enableFullTextQuery": "False"
           },
+          "capacityMode": "Provisioned",
+          "capacityModeChangeTransitionState": {
+            "capacityModeTransitionBeginTimestamp": "2024-03-24T03:02:16.2747253Z",
+            "capacityModeTransitionStatus": "Completed",
+            "capacityModeLastSuccessfulTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+            "capacityModeTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+            "currentCapacityMode": "Provisioned",
+            "previousCapacityMode": "Serverless"
+          },
           "enableMaterializedViews": false,
           "keysMetadata": {
             "primaryMasterKey": {
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountList.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountList.json
index c42a23097cbe..62576986baf7 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountList.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountList.json
@@ -96,6 +96,15 @@
               "enablePartitionMerge": true,
               "enableBurstCapacity": true,
               "minimalTlsVersion": "Tls",
+              "capacityMode": "Provisioned",
+              "capacityModeChangeTransitionState": {
+                "capacityModeTransitionBeginTimestamp": "2024-03-24T03:02:16.2747253Z",
+                "capacityModeTransitionStatus": "Completed",
+                "capacityModeLastSuccessfulTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+                "capacityModeTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+                "currentCapacityMode": "Provisioned",
+                "previousCapacityMode": "Serverless"
+              },
               "enableMaterializedViews": false,
               "keysMetadata": {
                 "primaryMasterKey": {
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountListByResourceGroup.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountListByResourceGroup.json
index 440ed5bf4e56..802c32c94e84 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountListByResourceGroup.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountListByResourceGroup.json
@@ -75,6 +75,15 @@
               },
               "networkAclBypass": "None",
               "networkAclBypassResourceIds": [],
+              "capacityMode": "Provisioned",
+              "capacityModeChangeTransitionState": {
+                "capacityModeTransitionBeginTimestamp": "2024-03-24T03:02:16.2747253Z",
+                "capacityModeTransitionStatus": "Completed",
+                "capacityModeLastSuccessfulTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+                "capacityModeTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+                "currentCapacityMode": "Provisioned",
+                "previousCapacityMode": "Serverless"
+              },
               "enableMaterializedViews": false,
               "minimalTlsVersion": "Tls",
               "keysMetadata": {
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountPatch.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountPatch.json
index deef972bf99c..ea58c2384a50 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountPatch.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBDatabaseAccountPatch.json
@@ -57,6 +57,7 @@
         "capacity": {
           "totalThroughputLimit": 2000
         },
+        "capacityMode": "Provisioned",
         "diagnosticLogSettings": {
           "enableFullTextQuery": "True"
         },
@@ -192,6 +193,15 @@
           "diagnosticLogSettings": {
             "enableFullTextQuery": "True"
           },
+          "capacityMode": "Provisioned",
+          "capacityModeChangeTransitionState": {
+            "capacityModeTransitionBeginTimestamp": "2024-03-24T03:02:16.2747253Z",
+            "capacityModeTransitionStatus": "Completed",
+            "capacityModeLastSuccessfulTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+            "capacityModeTransitionEndTimestamp": "2024-03-24T03:02:18.8758329Z",
+            "currentCapacityMode": "Provisioned",
+            "previousCapacityMode": "Serverless"
+          },
           "enableMaterializedViews": false,
           "enableBurstCapacity": true,
           "minimalTlsVersion": "Tls",
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBRestoreDatabaseAccountCreateUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBRestoreDatabaseAccountCreateUpdate.json
index 5f5f2c3cc2c0..e2ea5d52feaa 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBRestoreDatabaseAccountCreateUpdate.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-05-15-preview/examples/CosmosDBRestoreDatabaseAccountCreateUpdate.json
@@ -131,6 +131,7 @@
           "analyticalStorageConfiguration": null,
           "networkAclBypass": "None",
           "networkAclBypassResourceIds": [],
+          "capacityMode": "Provisioned",
           "enableMaterializedViews": false,
           "keysMetadata": {
             "primaryMasterKey": {