diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/cosmos-db.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/cosmos-db.json
index 3faef94dfa68..0fdfd127ec53 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/cosmos-db.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/cosmos-db.json
@@ -9736,6 +9736,13 @@
           "type": "string",
           "description": "The maximum throughput value or the maximum maxThroughput value (for autoscale) that can be specified",
           "readOnly": true
+        },
+        "throughputBuckets": {
+          "type": "array",
+          "description": "Array of Throughput Bucket limits to be applied to the Cosmos DB container",
+          "items": {
+            "$ref": "#/definitions/ThroughputBucketResource"
+          }
         }
       }
     },
@@ -9785,6 +9792,24 @@
         }
       }
     },
+    "ThroughputBucketResource": {
+      "type": "object",
+      "description": "Cosmos DB throughput bucket object",
+      "properties": {
+        "id": {
+          "type": "integer",
+          "description": "Represents the throughput bucket id"
+        },
+        "maxThroughputPercentage": {
+          "type": "integer",
+          "description": "Represents maximum percentage throughput that can be used by the bucket"
+        }
+      },
+      "required": [
+        "id",
+        "maxThroughputPercentage"
+      ]
+    },
     "OptionsResource": {
       "type": "object",
       "description": "Cosmos DB options resource object",
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputGet.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputGet.json
index db0315813fda..c5bc0baddff1 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputGet.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputGet.json
@@ -22,6 +22,28 @@
             "offerReplacePending": "true",
             "instantMaximumThroughput": "10000",
             "softAllowedMaximumThroughput": "1000000",
+            "throughputBuckets": [
+              {
+                "id": 1,
+                "maxThroughputPercentage": 10
+              },
+              {
+                "id": 2,
+                "maxThroughputPercentage": 5
+              },
+              {
+                "id": 3,
+                "maxThroughputPercentage": 15
+              },
+              {
+                "id": 4,
+                "maxThroughputPercentage": 10
+              },
+              {
+                "id": 5,
+                "maxThroughputPercentage": 20
+              }
+            ],
             "_rid": "PD5DALigDgw=",
             "_ts": 1459200611,
             "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""
diff --git a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputUpdate.json b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputUpdate.json
index b351a472e146..1e8b3a00aeae 100644
--- a/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputUpdate.json
+++ b/specification/cosmos-db/resource-manager/Microsoft.DocumentDB/preview/2024-12-01-preview/examples/CosmosDBSqlContainerThroughputUpdate.json
@@ -29,6 +29,28 @@
             "throughput": 400,
             "minimumThroughput": "400",
             "offerReplacePending": "true",
+            "throughputBuckets": [
+              {
+                "id": 1,
+                "maxThroughputPercentage": 10
+              },
+              {
+                "id": 2,
+                "maxThroughputPercentage": 5
+              },
+              {
+                "id": 3,
+                "maxThroughputPercentage": 15
+              },
+              {
+                "id": 4,
+                "maxThroughputPercentage": 10
+              },
+              {
+                "id": 5,
+                "maxThroughputPercentage": 20
+              }
+            ],
             "_rid": "PD5DALigDgw=",
             "_ts": 1459200611,
             "_etag": "\"00005900-0000-0000-0000-56f9a2630000\""