appwrite · loks0n · Aug 28, 2026 · Aug 27, 2026 · Aug 27, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,18 @@
 # Change Log
 
+## 30.0.0-rc.1
+
+* Breaking: `EmbeddingModel` no longer offers `embedding-gemma` or `bge-small`
+* Added: `documentsDB`, `vectorsDB`, `mysql`, `postgresql`, and `mongo` services, no longer hidden from server SDKs
+* Added: `DocumentsDBIndexType` and `VectorsDBIndexType` enums
+* Added: dedicated database models for branches, backups, restorations, poolers, PITR windows, extensions, and executions
+* Added: `PostgresExtension`, `VectorsdbCollection`, `AttributeObject`, and `AttributeVector` models
+* Added: `userId`, `emailHash`, and `name` parameters to `avatars.getPhoto`
+* Added: `error`, `containerStatus`, and `lifecycleState` on the `Database` model
+* Added: `changelogWatermark` on the `DatabaseMigration` model
+* Added: `total` on the `DedicatedDatabaseBranchList` model
+* Updated: `DedicatedDatabaseOperation.status` documents the new `queued` state
+
 ## 29.0.0
 
 * Breaking: requires PHP 8.5 or later, up from PHP 8.2

diff --git a/docs/documentsdb.md b/docs/documentsdb.md
diff --git a/docs/examples/avatars/get-initials.md b/docs/examples/avatars/get-initials.md
@@ -15,6 +15,6 @@ $result = $avatars->getInitials(
     name: '<NAME>', // optional
     width: 0, // optional
     height: 0, // optional
-    background: '' // optional
+    background: 'FFFFFF' // optional
 );
 ```
diff --git a/docs/examples/avatars/get-photo.md b/docs/examples/avatars/get-photo.md
@@ -17,7 +17,7 @@ $result = $avatars->getPhoto(
     quality: 0, // optional
     output: 'png', // optional
     rating: 'g', // optional
-    userId: '', // optional
+    userId: 'current()', // optional
     emailHash: '<EMAIL_HASH>', // optional
     name: '<NAME>' // optional
 );

diff --git a/docs/examples/databases/create-big-int-attribute.md b/docs/examples/databases/create-big-int-attribute.md
@@ -14,11 +14,11 @@ $databases = new Databases($client);
 $result = $databases->createBigIntAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    min: null, // optional
-    max: null, // optional
-    default: null, // optional
+    min: 0, // optional
+    max: 1000000, // optional
+    default: 0, // optional
     array: false // optional
 );
 ```
diff --git a/docs/examples/databases/create-boolean-attribute.md b/docs/examples/databases/create-boolean-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createBooleanAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: false, // optional
     array: false // optional

diff --git a/docs/examples/databases/create-datetime-attribute.md b/docs/examples/databases/create-datetime-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createDatetimeAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: '2020-10-15T06:38:00.000+00:00', // optional
     array: false // optional

diff --git a/docs/examples/databases/create-email-attribute.md b/docs/examples/databases/create-email-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createEmailAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: 'email@example.com', // optional
     array: false // optional

diff --git a/docs/examples/databases/create-enum-attribute.md b/docs/examples/databases/create-enum-attribute.md
@@ -14,10 +14,10 @@ $databases = new Databases($client);
 $result = $databases->createEnumAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
-    elements: [],
+    key: '<KEY>',
+    elements: ["active", "inactive"],
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'active', // optional
     array: false // optional
 );
 ```
diff --git a/docs/examples/databases/create-float-attribute.md b/docs/examples/databases/create-float-attribute.md
@@ -14,11 +14,11 @@ $databases = new Databases($client);
 $result = $databases->createFloatAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    min: null, // optional
-    max: null, // optional
-    default: null, // optional
+    min: 0, // optional
+    max: 100, // optional
+    default: 10.5, // optional
     array: false // optional
 );
 ```
diff --git a/docs/examples/databases/create-index.md b/docs/examples/databases/create-index.md
@@ -16,7 +16,7 @@ $databases = new Databases($client);
 $result = $databases->createIndex(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     type: DatabasesIndexType::KEY(),
     attributes: [],
     orders: [OrderBy::ASC()], // optional

diff --git a/docs/examples/databases/create-integer-attribute.md b/docs/examples/databases/create-integer-attribute.md
@@ -14,11 +14,11 @@ $databases = new Databases($client);
 $result = $databases->createIntegerAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    min: null, // optional
-    max: null, // optional
-    default: null, // optional
+    min: 0, // optional
+    max: 100, // optional
+    default: 10, // optional
     array: false // optional
 );
 ```
diff --git a/docs/examples/databases/create-ip-attribute.md b/docs/examples/databases/create-ip-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->createIpAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: '', // optional
+    default: '192.0.2.0', // optional
     array: false // optional
 );
 ```
diff --git a/docs/examples/databases/create-line-attribute.md b/docs/examples/databases/create-line-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createLineAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: [[1, 2], [3, 4], [5, 6]] // optional
 );

diff --git a/docs/examples/databases/create-longtext-attribute.md b/docs/examples/databases/create-longtext-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->createLongtextAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'Hello World', // optional
     array: false, // optional
     encrypt: false // optional
 );

diff --git a/docs/examples/databases/create-mediumtext-attribute.md b/docs/examples/databases/create-mediumtext-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->createMediumtextAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'Hello World', // optional
     array: false, // optional
     encrypt: false // optional
 );

diff --git a/docs/examples/databases/create-point-attribute.md b/docs/examples/databases/create-point-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createPointAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: [1, 2] // optional
 );

diff --git a/docs/examples/databases/create-polygon-attribute.md b/docs/examples/databases/create-polygon-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createPolygonAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: [[[1, 2], [3, 4], [5, 6], [1, 2]]] // optional
 );

diff --git a/docs/examples/databases/create-relationship-attribute.md b/docs/examples/databases/create-relationship-attribute.md
@@ -19,8 +19,8 @@ $result = $databases->createRelationshipAttribute(
     relatedCollectionId: '<RELATED_COLLECTION_ID>',
     type: RelationshipType::ONETOONE(),
     twoWay: false, // optional
-    key: '', // optional
-    twoWayKey: '', // optional
+    key: '<KEY>', // optional
+    twoWayKey: '<TWO_WAY_KEY>', // optional
     onDelete: RelationMutate::CASCADE() // optional
 );
 ```
diff --git a/docs/examples/databases/create-string-attribute.md b/docs/examples/databases/create-string-attribute.md
@@ -14,10 +14,10 @@ $databases = new Databases($client);
 $result = $databases->createStringAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     size: 1,
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'Hello World', // optional
     array: false, // optional
     encrypt: false // optional
 );

diff --git a/docs/examples/databases/create-text-attribute.md b/docs/examples/databases/create-text-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->createTextAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'Hello World', // optional
     array: false, // optional
     encrypt: false // optional
 );

diff --git a/docs/examples/databases/create-url-attribute.md b/docs/examples/databases/create-url-attribute.md
@@ -14,7 +14,7 @@ $databases = new Databases($client);
 $result = $databases->createUrlAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: 'https://example.com', // optional
     array: false // optional

diff --git a/docs/examples/databases/create-varchar-attribute.md b/docs/examples/databases/create-varchar-attribute.md
@@ -14,10 +14,10 @@ $databases = new Databases($client);
 $result = $databases->createVarcharAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     size: 1,
     required: false,
-    default: '<DEFAULT>', // optional
+    default: 'Hello World', // optional
     array: false, // optional
     encrypt: false // optional
 );

diff --git a/docs/examples/databases/decrement-document-attribute.md b/docs/examples/databases/decrement-document-attribute.md
@@ -15,9 +15,9 @@ $result = $databases->decrementDocumentAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
-    attribute: '',
-    value: null, // optional
-    min: null, // optional
+    attribute: '<ATTRIBUTE>',
+    value: 1, // optional
+    min: 0, // optional
     transactionId: '<TRANSACTION_ID>' // optional
 );
 ```
diff --git a/docs/examples/databases/delete-attribute.md b/docs/examples/databases/delete-attribute.md
@@ -14,6 +14,6 @@ $databases = new Databases($client);
 $result = $databases->deleteAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: ''
+    key: '<KEY>'
 );
 ```
diff --git a/docs/examples/databases/delete-index.md b/docs/examples/databases/delete-index.md
@@ -14,6 +14,6 @@ $databases = new Databases($client);
 $result = $databases->deleteIndex(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: ''
+    key: '<KEY>'
 );
 ```
diff --git a/docs/examples/databases/get-attribute.md b/docs/examples/databases/get-attribute.md
@@ -14,6 +14,6 @@ $databases = new Databases($client);
 $result = $databases->getAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: ''
+    key: '<KEY>'
 );
 ```
diff --git a/docs/examples/databases/get-index.md b/docs/examples/databases/get-index.md
@@ -14,6 +14,6 @@ $databases = new Databases($client);
 $result = $databases->getIndex(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: ''
+    key: '<KEY>'
 );
 ```
diff --git a/docs/examples/databases/increment-document-attribute.md b/docs/examples/databases/increment-document-attribute.md
@@ -15,9 +15,9 @@ $result = $databases->incrementDocumentAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
     documentId: '<DOCUMENT_ID>',
-    attribute: '',
-    value: null, // optional
-    max: null, // optional
+    attribute: '<ATTRIBUTE>',
+    value: 1, // optional
+    max: 100, // optional
     transactionId: '<TRANSACTION_ID>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-big-int-attribute.md b/docs/examples/databases/update-big-int-attribute.md
@@ -14,11 +14,11 @@ $databases = new Databases($client);
 $result = $databases->updateBigIntAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: null,
-    min: null, // optional
-    max: null, // optional
-    newKey: '' // optional
+    default: 0,
+    min: 0, // optional
+    max: 1000000, // optional
+    newKey: '<NEW_KEY>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-boolean-attribute.md b/docs/examples/databases/update-boolean-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->updateBooleanAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: false,
-    newKey: '' // optional
+    newKey: '<NEW_KEY>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-datetime-attribute.md b/docs/examples/databases/update-datetime-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->updateDatetimeAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: '2020-10-15T06:38:00.000+00:00',
-    newKey: '' // optional
+    newKey: '<NEW_KEY>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-email-attribute.md b/docs/examples/databases/update-email-attribute.md
@@ -14,9 +14,9 @@ $databases = new Databases($client);
 $result = $databases->updateEmailAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
     default: 'email@example.com',
-    newKey: '' // optional
+    newKey: '<NEW_KEY>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-enum-attribute.md b/docs/examples/databases/update-enum-attribute.md
@@ -14,10 +14,10 @@ $databases = new Databases($client);
 $result = $databases->updateEnumAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
-    elements: [],
+    key: '<KEY>',
+    elements: ["active", "inactive"],
     required: false,
-    default: '<DEFAULT>',
-    newKey: '' // optional
+    default: 'active',
+    newKey: '<NEW_KEY>' // optional
 );
 ```
diff --git a/docs/examples/databases/update-float-attribute.md b/docs/examples/databases/update-float-attribute.md
@@ -14,11 +14,11 @@ $databases = new Databases($client);
 $result = $databases->updateFloatAttribute(
     databaseId: '<DATABASE_ID>',
     collectionId: '<COLLECTION_ID>',
-    key: '',
+    key: '<KEY>',
     required: false,
-    default: null,
-    min: null, // optional
-    max: null, // optional
-    newKey: '' // optional
+    default: 10.5,
+    min: 0, // optional
+    max: 100, // optional
+    newKey: '<NEW_KEY>' // optional
 );
 ```