diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 3403973b0d..cebdc02163 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -8,7 +8,15 @@ env:
IMAGE: appwrite-dev
CACHE_KEY: appwrite-dev-${{ github.event.pull_request.head.sha }}
-on: [ pull_request ]
+on:
+ pull_request:
+ workflow_dispatch:
+ inputs:
+ response_format:
+ description: 'Response format version to test (e.g., 1.5.0, 1.4.0)'
+ required: false
+ type: string
+ default: ''
jobs:
check_database_changes:
@@ -100,7 +108,10 @@ jobs:
run: docker compose exec -T appwrite vars
- name: Run Unit Tests
- run: docker compose exec appwrite test /usr/src/code/tests/unit
+ run: |
+ docker compose exec \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
+ appwrite test /usr/src/code/tests/unit
e2e_general_test:
name: E2E General Test
@@ -132,7 +143,18 @@ jobs:
done
- name: Run General Tests
- run: docker compose exec -T appwrite test /usr/src/code/tests/e2e/General --debug
+ run: |
+ docker compose exec -T \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
+ appwrite test /usr/src/code/tests/e2e/General --debug
+
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
e2e_service_test:
name: E2E Service Test
@@ -146,7 +168,7 @@ jobs:
Avatars,
Console,
Databases/Legacy,
- Databases/Grids,
+ Databases/TablesDB,
Functions,
FunctionsSchedule,
GraphQL,
@@ -200,8 +222,17 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/${{ matrix.service }} --debug --exclude-group devKeys,screenshots
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
+
e2e_shared_mode_test:
name: E2E Shared Mode Service Test
runs-on: ubuntu-latest
@@ -216,7 +247,7 @@ jobs:
Avatars,
Console,
Databases/Legacy,
- Databases/Grids,
+ Databases/TablesDB,
Functions,
FunctionsSchedule,
GraphQL,
@@ -280,8 +311,17 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/${{ matrix.service }} --debug --exclude-group devKeys,screenshots
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
+
e2e_dev_keys:
name: E2E Service Test (Dev Keys)
runs-on: ubuntu-latest
@@ -313,8 +353,17 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/Projects --debug --group=devKeys
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
+
e2e_dev_keys_shared_mode:
name: E2E Shared Mode Service Test (Dev Keys)
runs-on: ubuntu-latest
@@ -360,8 +409,17 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/Projects --debug --group=devKeys
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
+
e2e_screenshots_keys:
name: E2E Service Test (Site Screenshots)
runs-on: ubuntu-latest
@@ -394,8 +452,17 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/Sites --debug --group=screenshots
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
+
e2e_screenshots_shared_mode:
name: E2E Shared Mode Service Test (Site Screenshots)
runs-on: ubuntu-latest
@@ -442,4 +509,13 @@ jobs:
docker compose exec -T \
-e _APP_DATABASE_SHARED_TABLES \
-e _APP_DATABASE_SHARED_TABLES_V1 \
+ -e _APP_E2E_RESPONSE_FORMAT="${{ github.event.inputs.response_format }}" \
appwrite test /usr/src/code/tests/e2e/Services/Sites --debug --group=screenshots
+
+ - name: Failure Logs
+ if: failure()
+ run: |
+ echo "=== Appwrite Worker Builds Logs ==="
+ docker compose logs appwrite-worker-builds
+ echo "=== OpenRuntimes Executor Logs ==="
+ docker compose logs openruntimes-executor
\ No newline at end of file
diff --git a/Dockerfile b/Dockerfile
index 845c5f6c1d..2a3e176838 100755
--- a/Dockerfile
+++ b/Dockerfile
@@ -12,7 +12,7 @@ RUN composer install --ignore-platform-reqs --optimize-autoloader \
--no-plugins --no-scripts --prefer-dist \
`if [ "$TESTING" != "true" ]; then echo "--no-dev"; fi`
-FROM appwrite/base:0.10.3 AS final
+FROM appwrite/base:0.10.4 AS final
LABEL maintainer="team@appwrite.io"
diff --git a/README.md b/README.md
index 7768d73015..9cd5808e33 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
+> We just announced Timestamp Overrides for Appwrite Databases - [Learn more](https://appwrite.io/blog/post/announcing-timestamp-overrides)
-> We just announced Auto-increment support for Appwrite Databases - [Learn more](https://appwrite.io/blog/post/announcing-auto-increment-support)
+> Appwrite Cloud is now Generally Available - [Learn more](https://appwrite.io/cloud-ga)
> [Get started with Appwrite](https://apwr.dev/appcloud)
diff --git a/app/cli.php b/app/cli.php
index 504e4fb5e6..0f98cf3458 100644
--- a/app/cli.php
+++ b/app/cli.php
@@ -194,12 +194,18 @@ CLI::setResource('publisher', function (Group $pools) {
CLI::setResource('publisherDatabases', function (BrokerPool $publisher) {
return $publisher;
}, ['publisher']);
+CLI::setResource('publisherFunctions', function (BrokerPool $publisher) {
+ return $publisher;
+}, ['publisher']);
CLI::setResource('publisherMigrations', function (BrokerPool $publisher) {
return $publisher;
}, ['publisher']);
CLI::setResource('publisherStatsUsage', function (BrokerPool $publisher) {
return $publisher;
}, ['publisher']);
+CLI::setResource('publisherMessaging', function (BrokerPool $publisher) {
+ return $publisher;
+}, ['publisher']);
CLI::setResource('queueForStatsUsage', function (Publisher $publisher) {
return new StatsUsage($publisher);
}, ['publisher']);
diff --git a/app/config/avatars/credit-cards.php b/app/config/avatars/credit-cards.php
index 52760bf9dc..b693e99fb2 100644
--- a/app/config/avatars/credit-cards.php
+++ b/app/config/avatars/credit-cards.php
@@ -13,7 +13,7 @@ return [
'mastercard' => ['name' => 'Mastercard', 'path' => __DIR__ . '/credit-cards/mastercard.png'],
'naranja' => ['name' => 'Naranja', 'path' => __DIR__ . '/credit-cards/naranja.png'],
'targeta-shopping' => ['name' => 'Tarjeta Shopping', 'path' => __DIR__ . '/credit-cards/tarjeta-shopping.png'],
- 'union-china-pay' => ['name' => 'Union China Pay', 'path' => __DIR__ . '/credit-cards/union-china-pay.png'],
+ 'unionpay' => ['name' => 'Union Pay', 'path' => __DIR__ . '/credit-cards/unionpay.png'],
'visa' => ['name' => 'Visa', 'path' => __DIR__ . '/credit-cards/visa.png'],
'mir' => ['name' => 'MIR', 'path' => __DIR__ . '/credit-cards/mir.png'],
'maestro' => ['name' => 'Maestro', 'path' => __DIR__ . '/credit-cards/maestro.png'],
diff --git a/app/config/avatars/credit-cards/union-china-pay.png b/app/config/avatars/credit-cards/unionpay.png
similarity index 100%
rename from app/config/avatars/credit-cards/union-china-pay.png
rename to app/config/avatars/credit-cards/unionpay.png
diff --git a/app/config/collections/projects.php b/app/config/collections/projects.php
index c380a856d0..e48dcef451 100644
--- a/app/config/collections/projects.php
+++ b/app/config/collections/projects.php
@@ -56,7 +56,7 @@ return [
'type' => Database::VAR_STRING,
'size' => 128,
'required' => false,
- 'default' => 'grids',
+ 'default' => 'tablesdb',
'signed' => true,
'array' => false,
'filters' => [],
@@ -1927,7 +1927,7 @@ return [
'$id' => ID::custom('errors'),
'type' => Database::VAR_STRING,
'format' => '',
- 'size' => 1000000,
+ 'size' => APP_FUNCTION_ERROR_LENGTH_LIMIT,
'signed' => true,
'required' => false,
'default' => null,
@@ -1938,7 +1938,7 @@ return [
'$id' => ID::custom('logs'),
'type' => Database::VAR_STRING,
'format' => '',
- 'size' => 1000000,
+ 'size' => APP_FUNCTION_LOG_LENGTH_LIMIT,
'signed' => true,
'required' => false,
'default' => null,
diff --git a/app/config/errors.php b/app/config/errors.php
index d786940c07..fa45550ba9 100644
--- a/app/config/errors.php
+++ b/app/config/errors.php
@@ -435,6 +435,11 @@ return [
'description' => 'The requested favicon could not be found.',
'code' => 404,
],
+ Exception::AVATAR_SVG_SANITIZATION_FAILED => [
+ 'name' => Exception::AVATAR_SVG_SANITIZATION_FAILED,
+ 'description' => 'SVG sanitization failed.',
+ 'code' => 400,
+ ],
/** Storage */
Exception::STORAGE_FILE_ALREADY_EXISTS => [
diff --git a/app/config/locale/templates/email-base-styled.tpl b/app/config/locale/templates/email-base-styled.tpl
index b5aece0253..16036e792c 100644
--- a/app/config/locale/templates/email-base-styled.tpl
+++ b/app/config/locale/templates/email-base-styled.tpl
@@ -1,9 +1,24 @@
-
-
-
+
+
-
-
-
-
-
-
-
diff --git a/app/config/platforms.php b/app/config/platforms.php
index 1b22522a24..a67381b596 100644
--- a/app/config/platforms.php
+++ b/app/config/platforms.php
@@ -11,7 +11,7 @@ return [
[
'key' => 'web',
'name' => 'Web',
- 'version' => '18.2.0',
+ 'version' => '19.0.0',
'url' => 'https://github.com/appwrite/sdk-for-web',
'package' => 'https://www.npmjs.com/package/appwrite',
'enabled' => true,
@@ -60,7 +60,7 @@ return [
[
'key' => 'flutter',
'name' => 'Flutter',
- 'version' => '17.1.0',
+ 'version' => '18.0.0',
'url' => 'https://github.com/appwrite/sdk-for-flutter',
'package' => 'https://pub.dev/packages/appwrite',
'enabled' => true,
@@ -79,7 +79,7 @@ return [
[
'key' => 'apple',
'name' => 'Apple',
- 'version' => '10.2.0',
+ 'version' => '11.0.0',
'url' => 'https://github.com/appwrite/sdk-for-apple',
'package' => 'https://github.com/appwrite/sdk-for-apple',
'enabled' => true,
@@ -116,7 +116,7 @@ return [
[
'key' => 'android',
'name' => 'Android',
- 'version' => '8.2.2',
+ 'version' => '9.0.0',
'url' => 'https://github.com/appwrite/sdk-for-android',
'package' => 'https://search.maven.org/artifact/io.appwrite/sdk-for-android',
'enabled' => true,
@@ -139,7 +139,7 @@ return [
[
'key' => 'react-native',
'name' => 'React Native',
- 'version' => '0.11.0',
+ 'version' => '0.12.0',
'url' => 'https://github.com/appwrite/sdk-for-react-native',
'package' => 'https://npmjs.com/package/react-native-appwrite',
'enabled' => true,
@@ -226,7 +226,7 @@ return [
[
'key' => 'cli',
'name' => 'Command Line',
- 'version' => '8.3.0',
+ 'version' => '9.0.2',
'url' => 'https://github.com/appwrite/sdk-for-cli',
'package' => 'https://www.npmjs.com/package/appwrite-cli',
'enabled' => true,
@@ -261,7 +261,7 @@ return [
[
'key' => 'nodejs',
'name' => 'Node.js',
- 'version' => '17.2.0',
+ 'version' => '18.0.0',
'url' => 'https://github.com/appwrite/sdk-for-node',
'package' => 'https://www.npmjs.com/package/node-appwrite',
'enabled' => true,
@@ -280,7 +280,7 @@ return [
[
'key' => 'deno',
'name' => 'Deno',
- 'version' => '15.1.0',
+ 'version' => '16.0.0',
'url' => 'https://github.com/appwrite/sdk-for-deno',
'package' => 'https://deno.land/x/appwrite',
'enabled' => true,
@@ -299,7 +299,7 @@ return [
[
'key' => 'php',
'name' => 'PHP',
- 'version' => '15.1.0',
+ 'version' => '16.0.0',
'url' => 'https://github.com/appwrite/sdk-for-php',
'package' => 'https://packagist.org/packages/appwrite/appwrite',
'enabled' => true,
@@ -318,7 +318,7 @@ return [
[
'key' => 'python',
'name' => 'Python',
- 'version' => '11.1.0',
+ 'version' => '12.0.0',
'url' => 'https://github.com/appwrite/sdk-for-python',
'package' => 'https://pypi.org/project/appwrite/',
'enabled' => true,
@@ -337,7 +337,7 @@ return [
[
'key' => 'ruby',
'name' => 'Ruby',
- 'version' => '16.1.0',
+ 'version' => '17.0.0',
'url' => 'https://github.com/appwrite/sdk-for-ruby',
'package' => 'https://rubygems.org/gems/appwrite',
'enabled' => true,
@@ -356,7 +356,7 @@ return [
[
'key' => 'go',
'name' => 'Go',
- 'version' => '0.9.0',
+ 'version' => '0.10.0',
'url' => 'https://github.com/appwrite/sdk-for-go',
'package' => 'https://github.com/appwrite/sdk-for-go',
'enabled' => true,
@@ -375,7 +375,7 @@ return [
[
'key' => 'dotnet',
'name' => '.NET',
- 'version' => '0.15.0',
+ 'version' => '0.16.0',
'url' => 'https://github.com/appwrite/sdk-for-dotnet',
'package' => 'https://www.nuget.org/packages/Appwrite',
'enabled' => true,
@@ -394,7 +394,7 @@ return [
[
'key' => 'dart',
'name' => 'Dart',
- 'version' => '16.2.0',
+ 'version' => '17.0.0',
'url' => 'https://github.com/appwrite/sdk-for-dart',
'package' => 'https://pub.dev/packages/dart_appwrite',
'enabled' => true,
@@ -413,7 +413,7 @@ return [
[
'key' => 'kotlin',
'name' => 'Kotlin',
- 'version' => '9.1.2',
+ 'version' => '10.0.0',
'url' => 'https://github.com/appwrite/sdk-for-kotlin',
'package' => 'https://search.maven.org/artifact/io.appwrite/sdk-for-kotlin',
'enabled' => true,
@@ -436,7 +436,7 @@ return [
[
'key' => 'swift',
'name' => 'Swift',
- 'version' => '10.2.0',
+ 'version' => '11.0.0',
'url' => 'https://github.com/appwrite/sdk-for-swift',
'package' => 'https://github.com/appwrite/sdk-for-swift',
'enabled' => true,
diff --git a/app/config/services.php b/app/config/services.php
index 696184d0c5..f02f169b88 100644
--- a/app/config/services.php
+++ b/app/config/services.php
@@ -66,15 +66,15 @@ return [
'optional' => true,
'icon' => '/images/services/databases.png',
],
- 'tables' => [
- 'key' => 'tables',
- 'name' => 'Tables',
- 'subtitle' => 'The Tables service allows you to create structured tables of rows, query and filter lists of rows',
- 'description' => '/docs/services/tables.md',
+ 'tablesdb' => [
+ 'key' => 'tablesdb',
+ 'name' => 'TablesDB',
+ 'subtitle' => 'The TablesDB service allows you to create structured tables of columns, query and filter lists of rows',
+ 'description' => '/docs/services/tablesdb.md',
'controller' => '', // Uses modules
'sdk' => true,
'docs' => true,
- 'docsUrl' => 'https://appwrite.io/docs/client/tables',
+ 'docsUrl' => 'https://appwrite.io/docs/client/tablesdb',
'tests' => false,
'optional' => true,
'icon' => '/images/services/databases.png',
diff --git a/app/config/specs/open-api3-1.7.x-client.json b/app/config/specs/open-api3-1.7.x-client.json
index 0bf589cb5a..c7de6a31af 100644
--- a/app/config/specs/open-api3-1.7.x-client.json
+++ b/app/config/specs/open-api3-1.7.x-client.json
@@ -2622,7 +2622,7 @@
"tags": [
"account"
],
- "description": "Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).",
+ "description": "Sends the user an email with a secret key for creating a session. If the email address has never been used, a **new account is created** using the provided `userId`. Otherwise, if the email address is already attached to an account, the **user ID is ignored**. Then, the user will receive an email with the one-time password. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).\n",
"responses": {
"201": {
"description": "Token",
@@ -2673,7 +2673,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": "
"
},
"email": {
@@ -2755,7 +2755,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2977,7 +2977,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the phone number has never been used, a new account is created using the provided userId. Otherwise, if the phone number is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"phone": {
@@ -3440,7 +3440,7 @@
"parameters": [
{
"name": "code",
- "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, union-china-pay, visa, mir, maestro, rupay.",
+ "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, unionpay, visa, mir, maestro, rupay.",
"required": true,
"schema": {
"type": "string",
@@ -3458,7 +3458,7 @@
"mastercard",
"naranja",
"targeta-shopping",
- "union-china-pay",
+ "unionpay",
"visa",
"mir",
"maestro",
@@ -3478,7 +3478,7 @@
"Mastercard",
"Naranja",
"Tarjeta Shopping",
- "Union China Pay",
+ "Union Pay",
"Visa",
"MIR",
"Maestro",
@@ -9847,6 +9847,11 @@
"description": "Function ID.",
"x-example": "5e5ea6g16897e"
},
+ "deploymentId": {
+ "type": "string",
+ "description": "Function's deployment ID used to create the execution.",
+ "x-example": "5e5ea5c16897e"
+ },
"trigger": {
"type": "string",
"description": "The trigger that caused the function to execute. Possible values can be: `http`, `schedule`, or `event`.",
@@ -9931,6 +9936,7 @@
"$updatedAt",
"$permissions",
"functionId",
+ "deploymentId",
"trigger",
"status",
"requestMethod",
@@ -9951,6 +9957,7 @@
"any"
],
"functionId": "5e5ea6g16897e",
+ "deploymentId": "5e5ea5c16897e",
"trigger": "http",
"status": "processing",
"requestMethod": "GET",
diff --git a/app/config/specs/open-api3-1.7.x-console.json b/app/config/specs/open-api3-1.7.x-console.json
index 5c6880a396..2554b7282c 100644
--- a/app/config/specs/open-api3-1.7.x-console.json
+++ b/app/config/specs/open-api3-1.7.x-console.json
@@ -2631,7 +2631,7 @@
"tags": [
"account"
],
- "description": "Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).",
+ "description": "Sends the user an email with a secret key for creating a session. If the email address has never been used, a **new account is created** using the provided `userId`. Otherwise, if the email address is already attached to an account, the **user ID is ignored**. Then, the user will receive an email with the one-time password. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).\n",
"responses": {
"201": {
"description": "Token",
@@ -2682,7 +2682,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2764,7 +2764,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2986,7 +2986,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the phone number has never been used, a new account is created using the provided userId. Otherwise, if the phone number is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"phone": {
@@ -3445,7 +3445,7 @@
"parameters": [
{
"name": "code",
- "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, union-china-pay, visa, mir, maestro, rupay.",
+ "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, unionpay, visa, mir, maestro, rupay.",
"required": true,
"schema": {
"type": "string",
@@ -3463,7 +3463,7 @@
"mastercard",
"naranja",
"targeta-shopping",
- "union-china-pay",
+ "unionpay",
"visa",
"mir",
"maestro",
@@ -3483,7 +3483,7 @@
"Mastercard",
"Naranja",
"Tarjeta Shopping",
- "Union China Pay",
+ "Union Pay",
"Visa",
"MIR",
"Maestro",
@@ -41133,6 +41133,11 @@
"description": "Function ID.",
"x-example": "5e5ea6g16897e"
},
+ "deploymentId": {
+ "type": "string",
+ "description": "Function's deployment ID used to create the execution.",
+ "x-example": "5e5ea5c16897e"
+ },
"trigger": {
"type": "string",
"description": "The trigger that caused the function to execute. Possible values can be: `http`, `schedule`, or `event`.",
@@ -41217,6 +41222,7 @@
"$updatedAt",
"$permissions",
"functionId",
+ "deploymentId",
"trigger",
"status",
"requestMethod",
@@ -41237,6 +41243,7 @@
"any"
],
"functionId": "5e5ea6g16897e",
+ "deploymentId": "5e5ea5c16897e",
"trigger": "http",
"status": "processing",
"requestMethod": "GET",
diff --git a/app/config/specs/open-api3-1.7.x-server.json b/app/config/specs/open-api3-1.7.x-server.json
index 35e3f14595..65eb2b29d0 100644
--- a/app/config/specs/open-api3-1.7.x-server.json
+++ b/app/config/specs/open-api3-1.7.x-server.json
@@ -2303,7 +2303,7 @@
"tags": [
"account"
],
- "description": "Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).",
+ "description": "Sends the user an email with a secret key for creating a session. If the email address has never been used, a **new account is created** using the provided `userId`. Otherwise, if the email address is already attached to an account, the **user ID is ignored**. Then, the user will receive an email with the one-time password. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).\n",
"responses": {
"201": {
"description": "Token",
@@ -2354,7 +2354,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2436,7 +2436,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2658,7 +2658,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the phone number has never been used, a new account is created using the provided userId. Otherwise, if the phone number is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"phone": {
@@ -3129,7 +3129,7 @@
"parameters": [
{
"name": "code",
- "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, union-china-pay, visa, mir, maestro, rupay.",
+ "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, unionpay, visa, mir, maestro, rupay.",
"required": true,
"schema": {
"type": "string",
@@ -3147,7 +3147,7 @@
"mastercard",
"naranja",
"targeta-shopping",
- "union-china-pay",
+ "unionpay",
"visa",
"mir",
"maestro",
@@ -3167,7 +3167,7 @@
"Mastercard",
"Naranja",
"Tarjeta Shopping",
- "Union China Pay",
+ "Union Pay",
"Visa",
"MIR",
"Maestro",
@@ -30230,6 +30230,11 @@
"description": "Function ID.",
"x-example": "5e5ea6g16897e"
},
+ "deploymentId": {
+ "type": "string",
+ "description": "Function's deployment ID used to create the execution.",
+ "x-example": "5e5ea5c16897e"
+ },
"trigger": {
"type": "string",
"description": "The trigger that caused the function to execute. Possible values can be: `http`, `schedule`, or `event`.",
@@ -30314,6 +30319,7 @@
"$updatedAt",
"$permissions",
"functionId",
+ "deploymentId",
"trigger",
"status",
"requestMethod",
@@ -30334,6 +30340,7 @@
"any"
],
"functionId": "5e5ea6g16897e",
+ "deploymentId": "5e5ea5c16897e",
"trigger": "http",
"status": "processing",
"requestMethod": "GET",
diff --git a/app/config/specs/open-api3-1.8.x-client.json b/app/config/specs/open-api3-1.8.x-client.json
index 69cdf83180..0841dabbd1 100644
--- a/app/config/specs/open-api3-1.8.x-client.json
+++ b/app/config/specs/open-api3-1.8.x-client.json
@@ -383,7 +383,7 @@
"weight": 30,
"cookies": false,
"type": "",
- "demo": "account\/create-j-w-t.md",
+ "demo": "account\/create-jwt.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-jwt.md",
"rate-limit": 100,
"rate-time": 3600,
@@ -498,7 +498,7 @@
"weight": 45,
"cookies": false,
"type": "",
- "demo": "account\/update-m-f-a.md",
+ "demo": "account\/update-mfa.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/update-mfa.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -561,7 +561,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaAuthenticator",
"group": "mfa",
@@ -579,6 +579,60 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "createMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaType"
+ }
+ ],
+ "description": "Add an authenticator app to be used as an MFA factor. Verify the authenticator using the [verify authenticator](\/docs\/references\/cloud\/client-web\/account#updateMfaAuthenticator) method.",
+ "demo": "account\/create-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAAuthenticator"
+ }
+ },
+ {
+ "name": "createMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaType"
+ }
+ ],
+ "description": "Add an authenticator app to be used as an MFA factor. Verify the authenticator using the [verify authenticator](\/docs\/references\/cloud\/client-web\/account#updateMfaAuthenticator) method.",
+ "demo": "account\/create-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -627,7 +681,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaAuthenticator",
"group": "mfa",
@@ -645,6 +699,64 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "updateMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type",
+ "otp"
+ ],
+ "required": [
+ "type",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/user"
+ }
+ ],
+ "description": "Verify an authenticator app after adding it using the [add authenticator](\/docs\/references\/cloud\/client-web\/account#createMfaAuthenticator) method.",
+ "demo": "account\/update-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAAuthenticator"
+ }
+ },
+ {
+ "name": "updateMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type",
+ "otp"
+ ],
+ "required": [
+ "type",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/user"
+ }
+ ],
+ "description": "Verify an authenticator app after adding it using the [add authenticator](\/docs\/references\/cloud\/client-web\/account#createMfaAuthenticator) method.",
+ "demo": "account\/update-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -705,7 +817,7 @@
"description": "No content"
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "deleteMfaAuthenticator",
"group": "mfa",
@@ -723,6 +835,58 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.deleteMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "deleteMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Delete an authenticator for a user by ID.",
+ "demo": "account\/delete-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.deleteMFAAuthenticator"
+ }
+ },
+ {
+ "name": "deleteMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Delete an authenticator for a user by ID.",
+ "demo": "account\/delete-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -773,7 +937,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaChallenge",
"group": "mfa",
@@ -791,6 +955,60 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAChallenge"
+ },
+ "methods": [
+ {
+ "name": "createMfaChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "factor"
+ ],
+ "required": [
+ "factor"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaChallenge"
+ }
+ ],
+ "description": "Begin the process of MFA verification after sign-in. Finish the flow with [updateMfaChallenge](\/docs\/references\/cloud\/client-web\/account#updateMfaChallenge) method.",
+ "demo": "account\/create-mfa-challenge.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAChallenge"
+ }
+ },
+ {
+ "name": "createMFAChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "factor"
+ ],
+ "required": [
+ "factor"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaChallenge"
+ }
+ ],
+ "description": "Begin the process of MFA verification after sign-in. Finish the flow with [updateMfaChallenge](\/docs\/references\/cloud\/client-web\/account#updateMfaChallenge) method.",
+ "demo": "account\/create-mfa-challenge.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -847,7 +1065,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaChallenge",
"group": "mfa",
@@ -865,6 +1083,64 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAChallenge"
+ },
+ "methods": [
+ {
+ "name": "updateMfaChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "challengeId",
+ "otp"
+ ],
+ "required": [
+ "challengeId",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/session"
+ }
+ ],
+ "description": "Complete the MFA challenge by providing the one-time password. Finish the process of MFA verification by providing the one-time password. To begin the flow, use [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/update-mfa-challenge.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAChallenge"
+ }
+ },
+ {
+ "name": "updateMFAChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "challengeId",
+ "otp"
+ ],
+ "required": [
+ "challengeId",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/session"
+ }
+ ],
+ "description": "Complete the MFA challenge by providing the one-time password. Finish the process of MFA verification by providing the one-time password. To begin the flow, use [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/update-mfa-challenge.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -923,7 +1199,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "listMfaFactors",
"group": "mfa",
@@ -941,6 +1217,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.listMFAFactors"
+ },
+ "methods": [
+ {
+ "name": "listMfaFactors",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaFactors"
+ }
+ ],
+ "description": "List the factors available on the account to be used as a MFA challange.",
+ "demo": "account\/list-mfa-factors.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.listMFAFactors"
+ }
+ },
+ {
+ "name": "listMFAFactors",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaFactors"
+ }
+ ],
+ "description": "List the factors available on the account to be used as a MFA challange.",
+ "demo": "account\/list-mfa-factors.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -974,7 +1296,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "getMfaRecoveryCodes",
"group": "mfa",
@@ -992,6 +1314,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.getMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "getMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Get recovery codes that can be used as backup for MFA flow. Before getting codes, they must be generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to read recovery codes.",
+ "demo": "account\/get-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.getMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "getMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Get recovery codes that can be used as backup for MFA flow. Before getting codes, they must be generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to read recovery codes.",
+ "demo": "account\/get-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1023,7 +1391,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaRecoveryCodes",
"group": "mfa",
@@ -1041,6 +1409,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "createMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Generate recovery codes as backup for MFA flow. It's recommended to generate and show then immediately after user successfully adds their authehticator. Recovery codes can be used as a MFA verification type in [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/create-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "createMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Generate recovery codes as backup for MFA flow. It's recommended to generate and show then immediately after user successfully adds their authehticator. Recovery codes can be used as a MFA verification type in [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/create-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1072,7 +1486,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaRecoveryCodes",
"group": "mfa",
@@ -1090,6 +1504,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "updateMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Regenerate recovery codes that can be used as backup for MFA flow. Before regenerating codes, they must be first generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to regenreate recovery codes.",
+ "demo": "account\/update-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "updateMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Regenerate recovery codes that can be used as backup for MFA flow. Before regenerating codes, they must be first generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to regenreate recovery codes.",
+ "demo": "account\/update-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1845,7 +2305,7 @@
"weight": 27,
"cookies": false,
"type": "",
- "demo": "account\/update-magic-u-r-l-session.md",
+ "demo": "account\/update-magic-url-session.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-session.md",
"rate-limit": 10,
"rate-time": 3600,
@@ -1856,6 +2316,10 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.6.0",
+ "replaceWith": "account.createSession"
+ },
"auth": {
"Project": []
}
@@ -1912,7 +2376,7 @@
"weight": 20,
"cookies": false,
"type": "webAuth",
- "demo": "account\/create-o-auth2session.md",
+ "demo": "account\/create-o-auth-2-session.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-session-oauth2.md",
"rate-limit": 50,
"rate-time": 3600,
@@ -2065,6 +2529,10 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.6.0",
+ "replaceWith": "account.createSession"
+ },
"auth": {
"Project": []
}
@@ -2622,7 +3090,7 @@
"tags": [
"account"
],
- "description": "Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).",
+ "description": "Sends the user an email with a secret key for creating a session. If the email address has never been used, a **new account is created** using the provided `userId`. Otherwise, if the email address is already attached to an account, the **user ID is ignored**. Then, the user will receive an email with the one-time password. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).\n",
"responses": {
"201": {
"description": "Token",
@@ -2673,7 +3141,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2724,7 +3192,7 @@
"weight": 25,
"cookies": false,
"type": "",
- "demo": "account\/create-magic-u-r-l-token.md",
+ "demo": "account\/create-magic-url-token.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-token-magic-url.md",
"rate-limit": 60,
"rate-time": 3600,
@@ -2755,7 +3223,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2804,7 +3272,7 @@
"weight": 24,
"cookies": false,
"type": "webAuth",
- "demo": "account\/create-o-auth2token.md",
+ "demo": "account\/create-o-auth-2-token.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-token-oauth2.md",
"rate-limit": 50,
"rate-time": 3600,
@@ -2977,7 +3445,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the phone number has never been used, a new account is created using the provided userId. Otherwise, if the phone number is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"phone": {
@@ -3440,7 +3908,7 @@
"parameters": [
{
"name": "code",
- "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, union-china-pay, visa, mir, maestro, rupay.",
+ "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, unionpay, visa, mir, maestro, rupay.",
"required": true,
"schema": {
"type": "string",
@@ -3458,7 +3926,7 @@
"mastercard",
"naranja",
"targeta-shopping",
- "union-china-pay",
+ "unionpay",
"visa",
"mir",
"maestro",
@@ -3478,7 +3946,7 @@
"Mastercard",
"Naranja",
"Tarjeta Shopping",
- "Union China Pay",
+ "Union Pay",
"Visa",
"MIR",
"Maestro",
@@ -4266,7 +4734,7 @@
"weight": 65,
"cookies": false,
"type": "location",
- "demo": "avatars\/get-q-r.md",
+ "demo": "avatars\/get-qr.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/avatars\/get-qr.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -4362,7 +4830,7 @@
"x-appwrite": {
"method": "listDocuments",
"group": "documents",
- "weight": 339,
+ "weight": 340,
"cookies": false,
"type": "",
"demo": "databases\/list-documents.md",
@@ -4379,7 +4847,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listRows"
+ "replaceWith": "tablesDB.listRows"
},
"auth": {
"Project": []
@@ -4451,7 +4919,7 @@
"x-appwrite": {
"method": "createDocument",
"group": "documents",
- "weight": 331,
+ "weight": 332,
"cookies": false,
"type": "",
"demo": "databases\/create-document.md",
@@ -4468,12 +4936,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRow"
+ "replaceWith": "tablesDB.createRow"
},
"methods": [
{
"name": "createDocument",
"namespace": "databases",
+ "desc": "Create document",
"auth": {
"Project": []
},
@@ -4497,9 +4966,10 @@
}
],
"description": "Create a new Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "demo": "databases\/create-document.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRow"
+ "replaceWith": "tablesDB.createRow"
}
}
],
@@ -4599,7 +5069,7 @@
"x-appwrite": {
"method": "getDocument",
"group": "documents",
- "weight": 332,
+ "weight": 333,
"cookies": false,
"type": "",
"demo": "databases\/get-document.md",
@@ -4616,7 +5086,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getRow"
+ "replaceWith": "tablesDB.getRow"
},
"auth": {
"Project": []
@@ -4676,12 +5146,12 @@
]
},
"put": {
- "summary": "Create or update a document",
+ "summary": "Upsert a document",
"operationId": "databasesUpsertDocument",
"tags": [
"databases"
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"201": {
"description": "Document",
@@ -4698,7 +5168,7 @@
"x-appwrite": {
"method": "upsertDocument",
"group": "documents",
- "weight": 335,
+ "weight": 336,
"cookies": false,
"type": "",
"demo": "databases\/upsert-document.md",
@@ -4715,12 +5185,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRow"
+ "replaceWith": "tablesDB.upsertRow"
},
"methods": [
{
"name": "upsertDocument",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -4743,10 +5214,11 @@
"model": "#\/components\/schemas\/document"
}
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "demo": "databases\/upsert-document.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRow"
+ "replaceWith": "tablesDB.upsertRow"
}
}
],
@@ -4844,7 +5316,7 @@
"x-appwrite": {
"method": "updateDocument",
"group": "documents",
- "weight": 333,
+ "weight": 334,
"cookies": false,
"type": "",
"demo": "databases\/update-document.md",
@@ -4861,7 +5333,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateRow"
+ "replaceWith": "tablesDB.updateRow"
},
"auth": {
"Project": []
@@ -4947,7 +5419,7 @@
"x-appwrite": {
"method": "deleteDocument",
"group": "documents",
- "weight": 337,
+ "weight": 338,
"cookies": false,
"type": "",
"demo": "databases\/delete-document.md",
@@ -4964,7 +5436,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteRow"
+ "replaceWith": "tablesDB.deleteRow"
},
"auth": {
"Project": []
@@ -5011,159 +5483,50 @@
]
}
},
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows": {
- "get": {
- "summary": "List rows",
- "operationId": "gridsListRows",
+ "\/databases\/{databaseId}\/collections\/{collectionId}\/documents\/{documentId}\/{attribute}\/decrement": {
+ "patch": {
+ "summary": "Decrement document attribute",
+ "operationId": "databasesDecrementDocumentAttribute",
"tags": [
- "grids"
+ "databases"
],
- "description": "Get a list of all the user's rows in a given table. You can use the query params to filter your results.",
+ "description": "Decrement a specific attribute of a document by a given value.",
"responses": {
"200": {
- "description": "Rows List",
+ "description": "Document",
"content": {
"application\/json": {
"schema": {
- "$ref": "#\/components\/schemas\/rowList"
+ "$ref": "#\/components\/schemas\/document"
}
}
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
- "method": "listRows",
- "group": "rows",
- "weight": 412,
+ "method": "decrementDocumentAttribute",
+ "group": "documents",
+ "weight": 343,
"cookies": false,
"type": "",
- "demo": "grids\/list-rows.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/list-rows.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "rows.read",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Session": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- },
- "post": {
- "summary": "Create row",
- "operationId": "gridsCreateRow",
- "tags": [
- "grids"
- ],
- "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.",
- "responses": {
- "201": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createRow",
- "group": "rows",
- "weight": 404,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-row.md",
+ "demo": "databases\/decrement-document-attribute.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/databases\/decrement-document-attribute.md",
"rate-limit": 120,
"rate-time": 60,
"rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
+ "scope": "documents.write",
"platforms": [
"client",
"server",
+ "console",
"server"
],
"packaging": false,
- "methods": [
- {
- "name": "createRow",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rowId",
- "data",
- "permissions"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rowId",
- "data"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/row"
- }
- ],
- "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console."
- }
- ],
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "tablesDB.decrementRowColumn"
+ },
"auth": {
"Project": []
}
@@ -5187,12 +5550,31 @@
"in": "path"
},
{
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate). Make sure to define columns before creating rows.",
+ "name": "collectionId",
+ "description": "Collection ID.",
"required": true,
"schema": {
"type": "string",
- "x-example": ""
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "documentId",
+ "description": "Document ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "attribute",
+ "description": "Attribute key.",
+ "required": true,
+ "schema": {
+ "type": "string"
},
"in": "path"
}
@@ -5203,31 +5585,15 @@
"schema": {
"type": "object",
"properties": {
- "rowId": {
- "type": "string",
- "description": "Row ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
- "x-example": ""
+ "value": {
+ "type": "number",
+ "description": "Value to increment the attribute by. The value must be a number.",
+ "x-example": null
},
- "data": {
- "type": "object",
- "description": "Row data as JSON object.",
- "x-example": "{}"
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- },
- "rows": {
- "type": "array",
- "description": "Array of documents data as JSON objects.",
- "x-example": null,
- "items": {
- "type": "object"
- }
+ "min": {
+ "type": "number",
+ "description": "Minimum value for the attribute. If the current value is lesser than this value, an exception will be thrown.",
+ "x-example": null
}
}
}
@@ -5236,274 +5602,50 @@
}
}
},
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows\/{rowId}": {
- "get": {
- "summary": "Get row",
- "operationId": "gridsGetRow",
- "tags": [
- "grids"
- ],
- "description": "Get a row by its unique ID. This endpoint response returns a JSON object with the row data.",
- "responses": {
- "200": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getRow",
- "group": "rows",
- "weight": 405,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-row.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "rows.read",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Session": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- },
- "put": {
- "summary": "Create or update a row",
- "operationId": "gridsUpsertRow",
- "tags": [
- "grids"
- ],
- "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.",
- "responses": {
- "201": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "upsertRow",
- "group": "rows",
- "weight": 408,
- "cookies": false,
- "type": "",
- "demo": "grids\/upsert-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/upsert-row.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "methods": [
- {
- "name": "upsertRow",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rowId",
- "data",
- "permissions"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rowId"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/row"
- }
- ],
- "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console."
- }
- ],
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Session": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "data": {
- "type": "object",
- "description": "Row data as JSON object. Include all required columns of the row to be created or updated.",
- "x-example": "{}"
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- }
- }
- }
- }
- }
- }
- },
+ "\/databases\/{databaseId}\/collections\/{collectionId}\/documents\/{documentId}\/{attribute}\/increment": {
"patch": {
- "summary": "Update row",
- "operationId": "gridsUpdateRow",
+ "summary": "Increment document attribute",
+ "operationId": "databasesIncrementDocumentAttribute",
"tags": [
- "grids"
+ "databases"
],
- "description": "Update a row by its unique ID. Using the patch method you can pass only specific fields that will get updated.",
+ "description": "Increment a specific attribute of a document by a given value.",
"responses": {
"200": {
- "description": "Row",
+ "description": "Document",
"content": {
"application\/json": {
"schema": {
- "$ref": "#\/components\/schemas\/row"
+ "$ref": "#\/components\/schemas\/document"
}
}
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
- "method": "updateRow",
- "group": "rows",
- "weight": 406,
+ "method": "incrementDocumentAttribute",
+ "group": "documents",
+ "weight": 342,
"cookies": false,
"type": "",
- "demo": "grids\/update-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-row.md",
+ "demo": "databases\/increment-document-attribute.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/databases\/increment-document-attribute.md",
"rate-limit": 120,
"rate-time": 60,
"rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
+ "scope": "documents.write",
"platforms": [
"client",
"server",
+ "console",
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "tablesDB.incrementRowColumn"
+ },
"auth": {
"Project": []
}
@@ -5527,22 +5669,31 @@
"in": "path"
},
{
- "name": "tableId",
- "description": "Table ID.",
+ "name": "collectionId",
+ "description": "Collection ID.",
"required": true,
"schema": {
"type": "string",
- "x-example": ""
+ "x-example": ""
},
"in": "path"
},
{
- "name": "rowId",
- "description": "Row ID.",
+ "name": "documentId",
+ "description": "Document ID.",
"required": true,
"schema": {
"type": "string",
- "x-example": ""
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "attribute",
+ "description": "Attribute key.",
+ "required": true,
+ "schema": {
+ "type": "string"
},
"in": "path"
}
@@ -5553,99 +5704,21 @@
"schema": {
"type": "object",
"properties": {
- "data": {
- "type": "object",
- "description": "Row data as JSON object. Include only columns and value pairs to be updated.",
- "x-example": "{}"
+ "value": {
+ "type": "number",
+ "description": "Value to increment the attribute by. The value must be a number.",
+ "x-example": null
},
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
+ "max": {
+ "type": "number",
+ "description": "Maximum value for the attribute. If the current value is greater than this value, an error will be thrown.",
+ "x-example": null
}
}
}
}
}
}
- },
- "delete": {
- "summary": "Delete row",
- "operationId": "gridsDeleteRow",
- "tags": [
- "grids"
- ],
- "description": "Delete a row by its unique ID.",
- "responses": {
- "204": {
- "description": "No content"
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteRow",
- "group": "rows",
- "weight": 410,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-row.md",
- "rate-limit": 60,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Session": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ]
}
},
"\/functions\/{functionId}\/executions": {
@@ -5672,7 +5745,7 @@
"x-appwrite": {
"method": "listExecutions",
"group": "executions",
- "weight": 440,
+ "weight": 448,
"cookies": false,
"type": "",
"demo": "functions\/list-executions.md",
@@ -5747,7 +5820,7 @@
"x-appwrite": {
"method": "createExecution",
"group": "executions",
- "weight": 438,
+ "weight": 446,
"cookies": false,
"type": "",
"demo": "functions\/create-execution.md",
@@ -5808,7 +5881,7 @@
},
"method": {
"type": "string",
- "description": "HTTP method of execution. Default value is GET.",
+ "description": "HTTP method of execution. Default value is POST.",
"x-example": "GET",
"enum": [
"GET",
@@ -5816,7 +5889,8 @@
"PUT",
"PATCH",
"DELETE",
- "OPTIONS"
+ "OPTIONS",
+ "HEAD"
],
"x-enum-name": "ExecutionMethod",
"x-enum-keys": []
@@ -5862,7 +5936,7 @@
"x-appwrite": {
"method": "getExecution",
"group": "executions",
- "weight": 439,
+ "weight": 447,
"cookies": false,
"type": "",
"demo": "functions\/get-execution.md",
@@ -5936,7 +6010,7 @@
"x-appwrite": {
"method": "query",
"group": "graphql",
- "weight": 254,
+ "weight": 255,
"cookies": false,
"type": "graphql",
"demo": "graphql\/query.md",
@@ -5988,7 +6062,7 @@
"x-appwrite": {
"method": "mutation",
"group": "graphql",
- "weight": 253,
+ "weight": 254,
"cookies": false,
"type": "graphql",
"demo": "graphql\/mutation.md",
@@ -6251,7 +6325,7 @@
"weight": 73,
"cookies": false,
"type": "",
- "demo": "locale\/list-countries-e-u.md",
+ "demo": "locale\/list-countries-eu.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/locale\/list-countries-eu.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -6456,7 +6530,7 @@
"x-appwrite": {
"method": "createSubscriber",
"group": "subscribers",
- "weight": 300,
+ "weight": 301,
"cookies": false,
"type": "",
"demo": "messaging\/create-subscriber.md",
@@ -6539,7 +6613,7 @@
"x-appwrite": {
"method": "deleteSubscriber",
"group": "subscribers",
- "weight": 304,
+ "weight": 305,
"cookies": false,
"type": "",
"demo": "messaging\/delete-subscriber.md",
@@ -7393,6 +7467,901 @@
]
}
},
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/rows": {
+ "get": {
+ "summary": "List rows",
+ "operationId": "tablesDBListRows",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a list of all the user's rows in a given table. You can use the query params to filter your results.",
+ "responses": {
+ "200": {
+ "description": "Rows List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/rowList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listRows",
+ "group": "rows",
+ "weight": 420,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-rows.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-rows.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "rows.read",
+ "documents.read"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the TableDB service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdbdb#tablesdbCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "post": {
+ "summary": "Create row",
+ "operationId": "tablesDBCreateRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "responses": {
+ "201": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createRow",
+ "group": "rows",
+ "weight": 412,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-row.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "methods": [
+ {
+ "name": "createRow",
+ "namespace": "tablesDB",
+ "desc": "Create row",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "databaseId",
+ "tableId",
+ "rowId",
+ "data",
+ "permissions"
+ ],
+ "required": [
+ "databaseId",
+ "tableId",
+ "rowId",
+ "data"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/row"
+ }
+ ],
+ "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "demo": "tablesdb\/create-row.md"
+ }
+ ],
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate). Make sure to define columns before creating rows.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "rowId": {
+ "type": "string",
+ "description": "Row ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "x-example": ""
+ },
+ "data": {
+ "type": "object",
+ "description": "Row data as JSON object.",
+ "x-example": "{}"
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ },
+ "rows": {
+ "type": "array",
+ "description": "Array of documents data as JSON objects.",
+ "x-example": null,
+ "items": {
+ "type": "object"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/rows\/{rowId}": {
+ "get": {
+ "summary": "Get row",
+ "operationId": "tablesDBGetRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a row by its unique ID. This endpoint response returns a JSON object with the row data.",
+ "responses": {
+ "200": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "getRow",
+ "group": "rows",
+ "weight": 413,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/get-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get-row.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "rows.read",
+ "documents.read"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "put": {
+ "summary": "Upsert a row",
+ "operationId": "tablesDBUpsertRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "responses": {
+ "201": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "upsertRow",
+ "group": "rows",
+ "weight": 416,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/upsert-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/upsert-row.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "methods": [
+ {
+ "name": "upsertRow",
+ "namespace": "tablesDB",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "databaseId",
+ "tableId",
+ "rowId",
+ "data",
+ "permissions"
+ ],
+ "required": [
+ "databaseId",
+ "tableId",
+ "rowId"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/row"
+ }
+ ],
+ "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "demo": "tablesdb\/upsert-row.md"
+ }
+ ],
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "data": {
+ "type": "object",
+ "description": "Row data as JSON object. Include all required columns of the row to be created or updated.",
+ "x-example": "{}"
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "patch": {
+ "summary": "Update row",
+ "operationId": "tablesDBUpdateRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a row by its unique ID. Using the patch method you can pass only specific fields that will get updated.",
+ "responses": {
+ "200": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateRow",
+ "group": "rows",
+ "weight": 414,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-row.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "data": {
+ "type": "object",
+ "description": "Row data as JSON object. Include only columns and value pairs to be updated.",
+ "x-example": "{}"
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "summary": "Delete row",
+ "operationId": "tablesDBDeleteRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Delete a row by its unique ID.",
+ "responses": {
+ "204": {
+ "description": "No content"
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "deleteRow",
+ "group": "rows",
+ "weight": 418,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/delete-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/delete-row.md",
+ "rate-limit": 60,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/rows\/{rowId}\/{column}\/decrement": {
+ "patch": {
+ "summary": "Decrement row column",
+ "operationId": "tablesDBDecrementRowColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Decrement a specific column of a row by a given value.",
+ "responses": {
+ "200": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "decrementRowColumn",
+ "group": "rows",
+ "weight": 423,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/decrement-row-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/decrement-row-column.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "console",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "column",
+ "description": "Column key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "number",
+ "description": "Value to increment the column by. The value must be a number.",
+ "x-example": null
+ },
+ "min": {
+ "type": "number",
+ "description": "Minimum value for the column. If the current value is lesser than this value, an exception will be thrown.",
+ "x-example": null
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/rows\/{rowId}\/{column}\/increment": {
+ "patch": {
+ "summary": "Increment row column",
+ "operationId": "tablesDBIncrementRowColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Increment a specific column of a row by a given value.",
+ "responses": {
+ "200": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "incrementRowColumn",
+ "group": "rows",
+ "weight": 422,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/increment-row-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/increment-row-column.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "console",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Session": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "rowId",
+ "description": "Row ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "column",
+ "description": "Column key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "value": {
+ "type": "number",
+ "description": "Value to increment the column by. The value must be a number.",
+ "x-example": null
+ },
+ "max": {
+ "type": "number",
+ "description": "Maximum value for the column. If the current value is greater than this value, an error will be thrown.",
+ "x-example": null
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
"\/teams": {
"get": {
"summary": "List teams",
@@ -8440,8 +9409,8 @@
"description": "The Databases service allows you to create structured collections of documents, query and filter lists of documents"
},
{
- "name": "tables",
- "description": "The Tables service allows you to create structured tables of rows, query and filter lists of rows"
+ "name": "tablesdb",
+ "description": "The TablesDB service allows you to create structured tables of columns, query and filter lists of rows"
},
{
"name": "locale",
@@ -8505,7 +9474,8 @@
"any": {
"description": "Any",
"type": "object",
- "additionalProperties": true
+ "additionalProperties": true,
+ "example": []
},
"error": {
"description": "Error",
@@ -8537,7 +9507,13 @@
"code",
"type",
"version"
- ]
+ ],
+ "example": {
+ "message": "Not found",
+ "code": "404",
+ "type": "not_found",
+ "version": "1.0"
+ }
},
"rowList": {
"description": "Rows List",
@@ -8545,7 +9521,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of rows rows that matched your query.",
+ "description": "Total number of rows that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8561,7 +9537,11 @@
"required": [
"total",
"rows"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "rows": ""
+ }
},
"documentList": {
"description": "Documents List",
@@ -8569,7 +9549,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of documents rows that matched your query.",
+ "description": "Total number of documents that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8585,7 +9565,11 @@
"required": [
"total",
"documents"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "documents": ""
+ }
},
"sessionList": {
"description": "Sessions List",
@@ -8593,7 +9577,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of sessions rows that matched your query.",
+ "description": "Total number of sessions that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8609,7 +9593,11 @@
"required": [
"total",
"sessions"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "sessions": ""
+ }
},
"identityList": {
"description": "Identities List",
@@ -8617,7 +9605,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of identities rows that matched your query.",
+ "description": "Total number of identities that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8633,7 +9621,11 @@
"required": [
"total",
"identities"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "identities": ""
+ }
},
"logList": {
"description": "Logs List",
@@ -8641,7 +9633,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of logs rows that matched your query.",
+ "description": "Total number of logs that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8657,7 +9649,11 @@
"required": [
"total",
"logs"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "logs": ""
+ }
},
"fileList": {
"description": "Files List",
@@ -8665,7 +9661,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of files rows that matched your query.",
+ "description": "Total number of files that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8681,7 +9677,11 @@
"required": [
"total",
"files"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "files": ""
+ }
},
"teamList": {
"description": "Teams List",
@@ -8689,7 +9689,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of teams rows that matched your query.",
+ "description": "Total number of teams that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8705,7 +9705,11 @@
"required": [
"total",
"teams"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "teams": ""
+ }
},
"membershipList": {
"description": "Memberships List",
@@ -8713,7 +9717,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of memberships rows that matched your query.",
+ "description": "Total number of memberships that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8729,7 +9733,11 @@
"required": [
"total",
"memberships"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "memberships": ""
+ }
},
"executionList": {
"description": "Executions List",
@@ -8737,7 +9745,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of executions rows that matched your query.",
+ "description": "Total number of executions that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8753,7 +9761,11 @@
"required": [
"total",
"executions"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "executions": ""
+ }
},
"countryList": {
"description": "Countries List",
@@ -8761,7 +9773,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of countries rows that matched your query.",
+ "description": "Total number of countries that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8777,7 +9789,11 @@
"required": [
"total",
"countries"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "countries": ""
+ }
},
"continentList": {
"description": "Continents List",
@@ -8785,7 +9801,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of continents rows that matched your query.",
+ "description": "Total number of continents that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8801,7 +9817,11 @@
"required": [
"total",
"continents"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "continents": ""
+ }
},
"languageList": {
"description": "Languages List",
@@ -8809,7 +9829,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of languages rows that matched your query.",
+ "description": "Total number of languages that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8825,7 +9845,11 @@
"required": [
"total",
"languages"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "languages": ""
+ }
},
"currencyList": {
"description": "Currencies List",
@@ -8833,7 +9857,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of currencies rows that matched your query.",
+ "description": "Total number of currencies that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8849,7 +9873,11 @@
"required": [
"total",
"currencies"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "currencies": ""
+ }
},
"phoneList": {
"description": "Phones List",
@@ -8857,7 +9885,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of phones rows that matched your query.",
+ "description": "Total number of phones that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8873,7 +9901,11 @@
"required": [
"total",
"phones"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "phones": ""
+ }
},
"localeCodeList": {
"description": "Locale codes list",
@@ -8881,7 +9913,7 @@
"properties": {
"total": {
"type": "integer",
- "description": "Total number of localeCodes rows that matched your query.",
+ "description": "Total number of localeCodes that matched your query.",
"x-example": 5,
"format": "int32"
},
@@ -8897,7 +9929,11 @@
"required": [
"total",
"localeCodes"
- ]
+ ],
+ "example": {
+ "total": 5,
+ "localeCodes": ""
+ }
},
"row": {
"description": "Row",
@@ -8912,17 +9948,20 @@
"type": "integer",
"description": "Row automatically incrementing ID.",
"x-example": 1,
- "format": "int32"
+ "format": "int32",
+ "readOnly": true
},
"$tableId": {
"type": "string",
"description": "Table ID.",
- "x-example": "5e5ea5c15117e"
+ "x-example": "5e5ea5c15117e",
+ "readOnly": true
},
"$databaseId": {
"type": "string",
"description": "Database ID.",
- "x-example": "5e5ea5c15117e"
+ "x-example": "5e5ea5c15117e",
+ "readOnly": true
},
"$createdAt": {
"type": "string",
@@ -8954,7 +9993,18 @@
"$createdAt",
"$updatedAt",
"$permissions"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$sequence": 1,
+ "$tableId": "5e5ea5c15117e",
+ "$databaseId": "5e5ea5c15117e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "$permissions": [
+ "read(\"any\")"
+ ]
+ }
},
"document": {
"description": "Document",
@@ -8969,17 +10019,20 @@
"type": "integer",
"description": "Document automatically incrementing ID.",
"x-example": 1,
- "format": "int32"
+ "format": "int32",
+ "readOnly": true
},
"$collectionId": {
"type": "string",
"description": "Collection ID.",
- "x-example": "5e5ea5c15117e"
+ "x-example": "5e5ea5c15117e",
+ "readOnly": true
},
"$databaseId": {
"type": "string",
"description": "Database ID.",
- "x-example": "5e5ea5c15117e"
+ "x-example": "5e5ea5c15117e",
+ "readOnly": true
},
"$createdAt": {
"type": "string",
@@ -9011,7 +10064,23 @@
"$createdAt",
"$updatedAt",
"$permissions"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$sequence": 1,
+ "$collectionId": "5e5ea5c15117e",
+ "$databaseId": "5e5ea5c15117e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "$permissions": [
+ "read(\"any\")"
+ ],
+ "username": "john.doe",
+ "email": "john.doe@example.com",
+ "fullName": "John Doe",
+ "age": 30,
+ "isAdmin": false
+ }
},
"log": {
"description": "Log",
@@ -9145,7 +10214,30 @@
"deviceModel",
"countryCode",
"countryName"
- ]
+ ],
+ "example": {
+ "event": "account.sessions.create",
+ "userId": "610fc2f985ee0",
+ "userEmail": "john@appwrite.io",
+ "userName": "John Doe",
+ "mode": "admin",
+ "ip": "127.0.0.1",
+ "time": "2020-10-15T06:38:00.000+00:00",
+ "osCode": "Mac",
+ "osName": "Mac",
+ "osVersion": "Mac",
+ "clientType": "browser",
+ "clientCode": "CM",
+ "clientName": "Chrome Mobile iOS",
+ "clientVersion": "84.0",
+ "clientEngine": "WebKit",
+ "clientEngineVersion": "605.1.15",
+ "deviceName": "smartphone",
+ "deviceBrand": "Google",
+ "deviceModel": "Nexus 5",
+ "countryCode": "US",
+ "countryName": "United States"
+ }
},
"user": {
"description": "User",
@@ -9306,7 +10398,33 @@
"prefs",
"targets",
"accessedAt"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "name": "John Doe",
+ "password": "$argon2id$v=19$m=2048,t=4,p=3$aUZjLnliVWRINmFNTWMudg$5S+x+7uA31xFnrHFT47yFwcJeaP0w92L\/4LdgrVRXxE",
+ "hash": "argon2",
+ "hashOptions": {},
+ "registration": "2020-10-15T06:38:00.000+00:00",
+ "status": true,
+ "labels": [
+ "vip"
+ ],
+ "passwordUpdate": "2020-10-15T06:38:00.000+00:00",
+ "email": "john@appwrite.io",
+ "phone": "+4930901820",
+ "emailVerification": true,
+ "phoneVerification": true,
+ "mfa": true,
+ "prefs": {
+ "theme": "pink",
+ "timezone": "UTC"
+ },
+ "targets": [],
+ "accessedAt": "2020-10-15T06:38:00.000+00:00"
+ }
},
"algoMd5": {
"description": "AlgoMD5",
@@ -9320,7 +10438,10 @@
},
"required": [
"type"
- ]
+ ],
+ "example": {
+ "type": "md5"
+ }
},
"algoSha": {
"description": "AlgoSHA",
@@ -9334,7 +10455,10 @@
},
"required": [
"type"
- ]
+ ],
+ "example": {
+ "type": "sha"
+ }
},
"algoPhpass": {
"description": "AlgoPHPass",
@@ -9348,7 +10472,10 @@
},
"required": [
"type"
- ]
+ ],
+ "example": {
+ "type": "phpass"
+ }
},
"algoBcrypt": {
"description": "AlgoBcrypt",
@@ -9362,7 +10489,10 @@
},
"required": [
"type"
- ]
+ ],
+ "example": {
+ "type": "bcrypt"
+ }
},
"algoScrypt": {
"description": "AlgoScrypt",
@@ -9404,7 +10534,14 @@
"costMemory",
"costParallel",
"length"
- ]
+ ],
+ "example": {
+ "type": "scrypt",
+ "costCpu": 8,
+ "costMemory": 14,
+ "costParallel": 1,
+ "length": 64
+ }
},
"algoScryptModified": {
"description": "AlgoScryptModified",
@@ -9436,7 +10573,13 @@
"salt",
"saltSeparator",
"signerKey"
- ]
+ ],
+ "example": {
+ "type": "scryptMod",
+ "salt": "UxLMreBr6tYyjQ==",
+ "saltSeparator": "Bw==",
+ "signerKey": "XyEKE9RcTDeLEsL\/RjwPDBv\/RqDl8fb3gpYEOQaPihbxf1ZAtSOHCjuAAa7Q3oHpCYhXSN9tizHgVOwn6krflQ=="
+ }
},
"algoArgon2": {
"description": "AlgoArgon2",
@@ -9471,12 +10614,23 @@
"memoryCost",
"timeCost",
"threads"
- ]
+ ],
+ "example": {
+ "type": "argon2",
+ "memoryCost": 65536,
+ "timeCost": 4,
+ "threads": 3
+ }
},
"preferences": {
"description": "Preferences",
"type": "object",
- "additionalProperties": true
+ "additionalProperties": true,
+ "example": {
+ "language": "en",
+ "timezone": "UTC",
+ "darkTheme": true
+ }
},
"session": {
"description": "Session",
@@ -9663,7 +10817,40 @@
"factors",
"secret",
"mfaUpdatedAt"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "userId": "5e5bb8c16897e",
+ "expire": "2020-10-15T06:38:00.000+00:00",
+ "provider": "email",
+ "providerUid": "user@example.com",
+ "providerAccessToken": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3",
+ "providerAccessTokenExpiry": "2020-10-15T06:38:00.000+00:00",
+ "providerRefreshToken": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3",
+ "ip": "127.0.0.1",
+ "osCode": "Mac",
+ "osName": "Mac",
+ "osVersion": "Mac",
+ "clientType": "browser",
+ "clientCode": "CM",
+ "clientName": "Chrome Mobile iOS",
+ "clientVersion": "84.0",
+ "clientEngine": "WebKit",
+ "clientEngineVersion": "605.1.15",
+ "deviceName": "smartphone",
+ "deviceBrand": "Google",
+ "deviceModel": "Nexus 5",
+ "countryCode": "US",
+ "countryName": "United States",
+ "current": true,
+ "factors": [
+ "email"
+ ],
+ "secret": "5e5bb8c16897e",
+ "mfaUpdatedAt": "2020-10-15T06:38:00.000+00:00"
+ }
},
"identity": {
"description": "Identity",
@@ -9731,7 +10918,19 @@
"providerAccessToken",
"providerAccessTokenExpiry",
"providerRefreshToken"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "userId": "5e5bb8c16897e",
+ "provider": "email",
+ "providerUid": "5e5bb8c16897e",
+ "providerEmail": "user@example.com",
+ "providerAccessToken": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3",
+ "providerAccessTokenExpiry": "2020-10-15T06:38:00.000+00:00",
+ "providerRefreshToken": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3"
+ }
},
"token": {
"description": "Token",
@@ -9775,7 +10974,15 @@
"secret",
"expire",
"phrase"
- ]
+ ],
+ "example": {
+ "$id": "bb8ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "userId": "5e5ea5c168bb8",
+ "secret": "",
+ "expire": "2020-10-15T06:38:00.000+00:00",
+ "phrase": "Golden Fox"
+ }
},
"jwt": {
"description": "JWT",
@@ -9789,7 +10996,10 @@
},
"required": [
"jwt"
- ]
+ ],
+ "example": {
+ "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
+ }
},
"locale": {
"description": "Locale",
@@ -9839,7 +11049,16 @@
"continent",
"eu",
"currency"
- ]
+ ],
+ "example": {
+ "ip": "127.0.0.1",
+ "countryCode": "US",
+ "country": "United States",
+ "continentCode": "NA",
+ "continent": "North America",
+ "eu": false,
+ "currency": "USD"
+ }
},
"localeCode": {
"description": "LocaleCode",
@@ -9859,7 +11078,11 @@
"required": [
"code",
"name"
- ]
+ ],
+ "example": {
+ "code": "en-us",
+ "name": "US"
+ }
},
"file": {
"description": "File",
@@ -9941,7 +11164,22 @@
"sizeOriginal",
"chunksTotal",
"chunksUploaded"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "bucketId": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "$permissions": [
+ "read(\"any\")"
+ ],
+ "name": "Pink.png",
+ "signature": "5d529fd02b544198ae075bd57c1762bb",
+ "mimeType": "image\/png",
+ "sizeOriginal": 17890,
+ "chunksTotal": 17890,
+ "chunksUploaded": 17890
+ }
},
"team": {
"description": "Team",
@@ -9992,7 +11230,18 @@
"name",
"total",
"prefs"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "name": "VIP",
+ "total": 7,
+ "prefs": {
+ "theme": "pink",
+ "timezone": "UTC"
+ }
+ }
},
"membership": {
"description": "Membership",
@@ -10083,7 +11332,24 @@
"confirm",
"mfa",
"roles"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "userId": "5e5ea5c16897e",
+ "userName": "John Doe",
+ "userEmail": "john@appwrite.io",
+ "teamId": "5e5ea5c16897e",
+ "teamName": "VIP",
+ "invited": "2020-10-15T06:38:00.000+00:00",
+ "joined": "2020-10-15T06:38:00.000+00:00",
+ "confirm": false,
+ "mfa": false,
+ "roles": [
+ "owner"
+ ]
+ }
},
"execution": {
"description": "Execution",
@@ -10101,7 +11367,7 @@
},
"$updatedAt": {
"type": "string",
- "description": "Execution upate date in ISO 8601 format.",
+ "description": "Execution update date in ISO 8601 format.",
"x-example": "2020-10-15T06:38:00.000+00:00"
},
"$permissions": {
@@ -10119,6 +11385,11 @@
"description": "Function ID.",
"x-example": "5e5ea6g16897e"
},
+ "deploymentId": {
+ "type": "string",
+ "description": "Function's deployment ID used to create the execution.",
+ "x-example": "5e5ea5c16897e"
+ },
"trigger": {
"type": "string",
"description": "The trigger that caused the function to execute. Possible values can be: `http`, `schedule`, or `event`.",
@@ -10203,6 +11474,7 @@
"$updatedAt",
"$permissions",
"functionId",
+ "deploymentId",
"trigger",
"status",
"requestMethod",
@@ -10214,7 +11486,37 @@
"logs",
"errors",
"duration"
- ]
+ ],
+ "example": {
+ "$id": "5e5ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "$permissions": [
+ "any"
+ ],
+ "functionId": "5e5ea6g16897e",
+ "deploymentId": "5e5ea5c16897e",
+ "trigger": "http",
+ "status": "processing",
+ "requestMethod": "GET",
+ "requestPath": "\/articles?id=5",
+ "requestHeaders": [
+ {
+ "Content-Type": "application\/json"
+ }
+ ],
+ "responseStatusCode": 200,
+ "responseBody": "",
+ "responseHeaders": [
+ {
+ "Content-Type": "application\/json"
+ }
+ ],
+ "logs": "",
+ "errors": "",
+ "duration": 0.4,
+ "scheduledAt": "2020-10-15T06:38:00.000+00:00"
+ }
},
"country": {
"description": "Country",
@@ -10234,7 +11536,11 @@
"required": [
"name",
"code"
- ]
+ ],
+ "example": {
+ "name": "United States",
+ "code": "US"
+ }
},
"continent": {
"description": "Continent",
@@ -10254,7 +11560,11 @@
"required": [
"name",
"code"
- ]
+ ],
+ "example": {
+ "name": "Europe",
+ "code": "EU"
+ }
},
"language": {
"description": "Language",
@@ -10280,7 +11590,12 @@
"name",
"code",
"nativeName"
- ]
+ ],
+ "example": {
+ "name": "Italian",
+ "code": "it",
+ "nativeName": "Italiano"
+ }
},
"currency": {
"description": "Currency",
@@ -10332,7 +11647,16 @@
"rounding",
"code",
"namePlural"
- ]
+ ],
+ "example": {
+ "symbol": "$",
+ "name": "US dollar",
+ "symbolNative": "$",
+ "decimalDigits": 2,
+ "rounding": 0,
+ "code": "USD",
+ "namePlural": "US dollars"
+ }
},
"phone": {
"description": "Phone",
@@ -10358,7 +11682,12 @@
"code",
"countryCode",
"countryName"
- ]
+ ],
+ "example": {
+ "code": "+1",
+ "countryCode": "US",
+ "countryName": "United States"
+ }
},
"headers": {
"description": "Headers",
@@ -10378,7 +11707,11 @@
"required": [
"name",
"value"
- ]
+ ],
+ "example": {
+ "name": "Content-Type",
+ "value": "application\/json"
+ }
},
"mfaChallenge": {
"description": "MFA Challenge",
@@ -10410,7 +11743,13 @@
"$createdAt",
"userId",
"expire"
- ]
+ ],
+ "example": {
+ "$id": "bb8ea5c16897e",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "userId": "5e5ea5c168bb8",
+ "expire": "2020-10-15T06:38:00.000+00:00"
+ }
},
"mfaRecoveryCodes": {
"description": "MFA Recovery Codes",
@@ -10430,7 +11769,13 @@
},
"required": [
"recoveryCodes"
- ]
+ ],
+ "example": {
+ "recoveryCodes": [
+ "a3kf0-s0cl2",
+ "s0co1-as98s"
+ ]
+ }
},
"mfaType": {
"description": "MFAType",
@@ -10450,7 +11795,11 @@
"required": [
"secret",
"uri"
- ]
+ ],
+ "example": {
+ "secret": true,
+ "uri": true
+ }
},
"mfaFactors": {
"description": "MFAFactors",
@@ -10482,7 +11831,13 @@
"phone",
"email",
"recoveryCode"
- ]
+ ],
+ "example": {
+ "totp": true,
+ "phone": true,
+ "email": true,
+ "recoveryCode": true
+ }
},
"subscriber": {
"description": "Subscriber",
@@ -10556,7 +11911,27 @@
"userName",
"topicId",
"providerType"
- ]
+ ],
+ "example": {
+ "$id": "259125845563242502",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "targetId": "259125845563242502",
+ "target": {
+ "$id": "259125845563242502",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "providerType": "email",
+ "providerId": "259125845563242502",
+ "name": "ageon-app-email",
+ "identifier": "random-mail@email.org",
+ "userId": "5e5ea5c16897e"
+ },
+ "userId": "5e5ea5c16897e",
+ "userName": "Aegon Targaryen",
+ "topicId": "259125845563242502",
+ "providerType": "email"
+ }
},
"target": {
"description": "Target",
@@ -10618,7 +11993,18 @@
"providerType",
"identifier",
"expired"
- ]
+ ],
+ "example": {
+ "$id": "259125845563242502",
+ "$createdAt": "2020-10-15T06:38:00.000+00:00",
+ "$updatedAt": "2020-10-15T06:38:00.000+00:00",
+ "name": "Apple iPhone 12",
+ "userId": "259125845563242502",
+ "providerId": "259125845563242502",
+ "providerType": "email",
+ "identifier": "token",
+ "expired": false
+ }
}
},
"securitySchemes": {
diff --git a/app/config/specs/open-api3-1.8.x-console.json b/app/config/specs/open-api3-1.8.x-console.json
index 4ee19cd594..31cb8e5105 100644
--- a/app/config/specs/open-api3-1.8.x-console.json
+++ b/app/config/specs/open-api3-1.8.x-console.json
@@ -418,7 +418,7 @@
"weight": 30,
"cookies": false,
"type": "",
- "demo": "account\/create-j-w-t.md",
+ "demo": "account\/create-jwt.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-jwt.md",
"rate-limit": 100,
"rate-time": 3600,
@@ -532,7 +532,7 @@
"weight": 45,
"cookies": false,
"type": "",
- "demo": "account\/update-m-f-a.md",
+ "demo": "account\/update-mfa.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/update-mfa.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -594,7 +594,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaAuthenticator",
"group": "mfa",
@@ -612,6 +612,60 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "createMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaType"
+ }
+ ],
+ "description": "Add an authenticator app to be used as an MFA factor. Verify the authenticator using the [verify authenticator](\/docs\/references\/cloud\/client-web\/account#updateMfaAuthenticator) method.",
+ "demo": "account\/create-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAAuthenticator"
+ }
+ },
+ {
+ "name": "createMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaType"
+ }
+ ],
+ "description": "Add an authenticator app to be used as an MFA factor. Verify the authenticator using the [verify authenticator](\/docs\/references\/cloud\/client-web\/account#updateMfaAuthenticator) method.",
+ "demo": "account\/create-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -659,7 +713,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaAuthenticator",
"group": "mfa",
@@ -677,6 +731,64 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "updateMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type",
+ "otp"
+ ],
+ "required": [
+ "type",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/user"
+ }
+ ],
+ "description": "Verify an authenticator app after adding it using the [add authenticator](\/docs\/references\/cloud\/client-web\/account#createMfaAuthenticator) method.",
+ "demo": "account\/update-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAAuthenticator"
+ }
+ },
+ {
+ "name": "updateMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type",
+ "otp"
+ ],
+ "required": [
+ "type",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/user"
+ }
+ ],
+ "description": "Verify an authenticator app after adding it using the [add authenticator](\/docs\/references\/cloud\/client-web\/account#createMfaAuthenticator) method.",
+ "demo": "account\/update-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -736,7 +848,7 @@
"description": "No content"
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "deleteMfaAuthenticator",
"group": "mfa",
@@ -754,6 +866,58 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.deleteMFAAuthenticator"
+ },
+ "methods": [
+ {
+ "name": "deleteMfaAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Delete an authenticator for a user by ID.",
+ "demo": "account\/delete-mfa-authenticator.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.deleteMFAAuthenticator"
+ }
+ },
+ {
+ "name": "deleteMFAAuthenticator",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "type"
+ ],
+ "required": [
+ "type"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Delete an authenticator for a user by ID.",
+ "demo": "account\/delete-mfa-authenticator.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -803,7 +967,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaChallenge",
"group": "mfa",
@@ -821,6 +985,60 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAChallenge"
+ },
+ "methods": [
+ {
+ "name": "createMfaChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "factor"
+ ],
+ "required": [
+ "factor"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaChallenge"
+ }
+ ],
+ "description": "Begin the process of MFA verification after sign-in. Finish the flow with [updateMfaChallenge](\/docs\/references\/cloud\/client-web\/account#updateMfaChallenge) method.",
+ "demo": "account\/create-mfa-challenge.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFAChallenge"
+ }
+ },
+ {
+ "name": "createMFAChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "factor"
+ ],
+ "required": [
+ "factor"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaChallenge"
+ }
+ ],
+ "description": "Begin the process of MFA verification after sign-in. Finish the flow with [updateMfaChallenge](\/docs\/references\/cloud\/client-web\/account#updateMfaChallenge) method.",
+ "demo": "account\/create-mfa-challenge.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -877,7 +1095,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaChallenge",
"group": "mfa",
@@ -895,6 +1113,64 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAChallenge"
+ },
+ "methods": [
+ {
+ "name": "updateMfaChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "challengeId",
+ "otp"
+ ],
+ "required": [
+ "challengeId",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/session"
+ }
+ ],
+ "description": "Complete the MFA challenge by providing the one-time password. Finish the process of MFA verification by providing the one-time password. To begin the flow, use [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/update-mfa-challenge.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFAChallenge"
+ }
+ },
+ {
+ "name": "updateMFAChallenge",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "challengeId",
+ "otp"
+ ],
+ "required": [
+ "challengeId",
+ "otp"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/session"
+ }
+ ],
+ "description": "Complete the MFA challenge by providing the one-time password. Finish the process of MFA verification by providing the one-time password. To begin the flow, use [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/update-mfa-challenge.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -952,7 +1228,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "listMfaFactors",
"group": "mfa",
@@ -970,6 +1246,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.listMFAFactors"
+ },
+ "methods": [
+ {
+ "name": "listMfaFactors",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaFactors"
+ }
+ ],
+ "description": "List the factors available on the account to be used as a MFA challange.",
+ "demo": "account\/list-mfa-factors.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.listMFAFactors"
+ }
+ },
+ {
+ "name": "listMFAFactors",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaFactors"
+ }
+ ],
+ "description": "List the factors available on the account to be used as a MFA challange.",
+ "demo": "account\/list-mfa-factors.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1002,7 +1324,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "getMfaRecoveryCodes",
"group": "mfa",
@@ -1020,6 +1342,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.getMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "getMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Get recovery codes that can be used as backup for MFA flow. Before getting codes, they must be generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to read recovery codes.",
+ "demo": "account\/get-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.getMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "getMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Get recovery codes that can be used as backup for MFA flow. Before getting codes, they must be generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to read recovery codes.",
+ "demo": "account\/get-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1050,7 +1418,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createMfaRecoveryCodes",
"group": "mfa",
@@ -1068,6 +1436,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "createMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Generate recovery codes as backup for MFA flow. It's recommended to generate and show then immediately after user successfully adds their authehticator. Recovery codes can be used as a MFA verification type in [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/create-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.createMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "createMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Generate recovery codes as backup for MFA flow. It's recommended to generate and show then immediately after user successfully adds their authehticator. Recovery codes can be used as a MFA verification type in [createMfaChallenge](\/docs\/references\/cloud\/client-web\/account#createMfaChallenge) method.",
+ "demo": "account\/create-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1098,7 +1512,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateMfaRecoveryCodes",
"group": "mfa",
@@ -1116,6 +1530,52 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFARecoveryCodes"
+ },
+ "methods": [
+ {
+ "name": "updateMfaRecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Regenerate recovery codes that can be used as backup for MFA flow. Before regenerating codes, they must be first generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to regenreate recovery codes.",
+ "demo": "account\/update-mfa-recovery-codes.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "account.updateMFARecoveryCodes"
+ }
+ },
+ {
+ "name": "updateMFARecoveryCodes",
+ "namespace": "account",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/mfaRecoveryCodes"
+ }
+ ],
+ "description": "Regenerate recovery codes that can be used as backup for MFA flow. Before regenerating codes, they must be first generated using [createMfaRecoveryCodes](\/docs\/references\/cloud\/client-web\/account#createMfaRecoveryCodes) method. An OTP challenge is required to regenreate recovery codes.",
+ "demo": "account\/update-mfa-recovery-codes.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -1861,7 +2321,7 @@
"weight": 27,
"cookies": false,
"type": "",
- "demo": "account\/update-magic-u-r-l-session.md",
+ "demo": "account\/update-magic-url-session.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-session.md",
"rate-limit": 10,
"rate-time": 3600,
@@ -1872,6 +2332,10 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.6.0",
+ "replaceWith": "account.createSession"
+ },
"auth": {
"Project": []
}
@@ -1928,7 +2392,7 @@
"weight": 20,
"cookies": false,
"type": "webAuth",
- "demo": "account\/create-o-auth2session.md",
+ "demo": "account\/create-o-auth-2-session.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-session-oauth2.md",
"rate-limit": 50,
"rate-time": 3600,
@@ -2081,6 +2545,10 @@
"client"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.6.0",
+ "replaceWith": "account.createSession"
+ },
"auth": {
"Project": []
}
@@ -2631,7 +3099,7 @@
"tags": [
"account"
],
- "description": "Sends the user an email with a secret key for creating a session. If the provided user ID has not be registered, a new user will be created. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).",
+ "description": "Sends the user an email with a secret key for creating a session. If the email address has never been used, a **new account is created** using the provided `userId`. Otherwise, if the email address is already attached to an account, the **user ID is ignored**. Then, the user will receive an email with the one-time password. Use the returned user ID and secret and submit a request to the [POST \/v1\/account\/sessions\/token](https:\/\/appwrite.io\/docs\/references\/cloud\/client-web\/account#createSession) endpoint to complete the login process. The secret sent to the user's email is valid for 15 minutes.\n\nA user is limited to 10 active sessions at a time by default. [Learn more about session limits](https:\/\/appwrite.io\/docs\/authentication-security#limits).\n",
"responses": {
"201": {
"description": "Token",
@@ -2682,7 +3150,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "User ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2733,7 +3201,7 @@
"weight": 25,
"cookies": false,
"type": "",
- "demo": "account\/create-magic-u-r-l-token.md",
+ "demo": "account\/create-magic-url-token.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-token-magic-url.md",
"rate-limit": 60,
"rate-time": 3600,
@@ -2764,7 +3232,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the email address has never been used, a new account is created using the provided userId. Otherwise, if the email address is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"email": {
@@ -2813,7 +3281,7 @@
"weight": 24,
"cookies": false,
"type": "webAuth",
- "demo": "account\/create-o-auth2token.md",
+ "demo": "account\/create-o-auth-2-token.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/account\/create-token-oauth2.md",
"rate-limit": 50,
"rate-time": 3600,
@@ -2986,7 +3454,7 @@
"properties": {
"userId": {
"type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars. If the phone number has never been used, a new account is created using the provided userId. Otherwise, if the phone number is already attached to an account, the user ID is ignored.",
"x-example": ""
},
"phone": {
@@ -3445,7 +3913,7 @@
"parameters": [
{
"name": "code",
- "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, union-china-pay, visa, mir, maestro, rupay.",
+ "description": "Credit Card Code. Possible values: amex, argencard, cabal, cencosud, diners, discover, elo, hipercard, jcb, mastercard, naranja, targeta-shopping, unionpay, visa, mir, maestro, rupay.",
"required": true,
"schema": {
"type": "string",
@@ -3463,7 +3931,7 @@
"mastercard",
"naranja",
"targeta-shopping",
- "union-china-pay",
+ "unionpay",
"visa",
"mir",
"maestro",
@@ -3483,7 +3951,7 @@
"Mastercard",
"Naranja",
"Tarjeta Shopping",
- "Union China Pay",
+ "Union Pay",
"Visa",
"MIR",
"Maestro",
@@ -4271,7 +4739,7 @@
"weight": 65,
"cookies": false,
"type": "location",
- "demo": "avatars\/get-q-r.md",
+ "demo": "avatars\/get-qr.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/avatars\/get-qr.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -4360,7 +4828,7 @@
"x-appwrite": {
"method": "chat",
"group": "console",
- "weight": 256,
+ "weight": 257,
"cookies": false,
"type": "",
"demo": "assistant\/chat.md",
@@ -4420,7 +4888,7 @@
"x-appwrite": {
"method": "getResource",
"group": null,
- "weight": 480,
+ "weight": 488,
"cookies": false,
"type": "",
"demo": "console\/get-resource.md",
@@ -4495,7 +4963,7 @@
"x-appwrite": {
"method": "variables",
"group": "console",
- "weight": 255,
+ "weight": 256,
"cookies": false,
"type": "",
"demo": "console\/variables.md",
@@ -4543,7 +5011,7 @@
"x-appwrite": {
"method": "list",
"group": "databases",
- "weight": 320,
+ "weight": 321,
"cookies": false,
"type": "",
"demo": "databases\/list.md",
@@ -4558,12 +5026,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabases"
+ "replaceWith": "tablesDB.list"
},
"methods": [
{
"name": "list",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -4579,29 +5048,11 @@
}
],
"description": "Get a list of all databases from the current Appwrite project. You can use the search parameter to filter your results.",
+ "demo": "databases\/list.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabases"
+ "replaceWith": "tablesDB.list"
}
- },
- {
- "name": "listDatabases",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "queries",
- "search"
- ],
- "required": [],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/databaseList"
- }
- ],
- "description": "Get a list of all databases from the current Appwrite project. You can use the search parameter to filter your results."
}
],
"auth": {
@@ -4664,7 +5115,7 @@
"x-appwrite": {
"method": "create",
"group": "databases",
- "weight": 316,
+ "weight": 317,
"cookies": false,
"type": "",
"demo": "databases\/create.md",
@@ -4679,12 +5130,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createDatabase"
+ "replaceWith": "tablesDB.create"
},
"methods": [
{
"name": "create",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -4704,33 +5156,11 @@
}
],
"description": "Create a new Database.\n",
+ "demo": "databases\/create.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createDatabase"
+ "replaceWith": "tablesDB.create"
}
- },
- {
- "name": "createDatabase",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "name",
- "enabled"
- ],
- "required": [
- "databaseId",
- "name"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/database"
- }
- ],
- "description": "Create a new Database.\n"
}
],
"auth": {
@@ -4782,7 +5212,7 @@
"tags": [
"databases"
],
- "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, collections\/tables, documents\/rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, collections, documents, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
"responses": {
"200": {
"description": "UsageDatabases",
@@ -4799,7 +5229,7 @@
"x-appwrite": {
"method": "listUsage",
"group": null,
- "weight": 323,
+ "weight": 324,
"cookies": false,
"type": "",
"demo": "databases\/list-usage.md",
@@ -4814,12 +5244,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabaseUsage"
+ "replaceWith": "tablesDB.listUsage"
},
"methods": [
{
"name": "listUsage",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -4833,29 +5264,12 @@
"model": "#\/components\/schemas\/usageDatabases"
}
],
- "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, collections\/tables, documents\/rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, collections, documents, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "demo": "databases\/list-usage.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabaseUsage"
+ "replaceWith": "tablesDB.listUsage"
}
- },
- {
- "name": "listDatabaseUsage",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "range"
- ],
- "required": [],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/usageDatabases"
- }
- ],
- "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, tables, rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days."
}
],
"auth": {
@@ -4880,7 +5294,7 @@
"30d",
"90d"
],
- "x-enum-name": "DatabaseUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -4917,7 +5331,7 @@
"x-appwrite": {
"method": "get",
"group": "databases",
- "weight": 317,
+ "weight": 318,
"cookies": false,
"type": "",
"demo": "databases\/get.md",
@@ -4932,12 +5346,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getDatabase"
+ "replaceWith": "tablesDB.get"
},
"methods": [
{
"name": "get",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -4954,30 +5369,11 @@
}
],
"description": "Get a database by its unique ID. This endpoint response returns a JSON object with the database metadata.",
+ "demo": "databases\/get.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getDatabase"
+ "replaceWith": "tablesDB.get"
}
- },
- {
- "name": "getDatabase",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId"
- ],
- "required": [
- "databaseId"
- ],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/database"
- }
- ],
- "description": "Get a database by its unique ID. This endpoint response returns a JSON object with the database metadata."
}
],
"auth": {
@@ -5026,7 +5422,7 @@
"x-appwrite": {
"method": "update",
"group": "databases",
- "weight": 318,
+ "weight": 319,
"cookies": false,
"type": "",
"demo": "databases\/update.md",
@@ -5041,12 +5437,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateDatabase"
+ "replaceWith": "tablesDB.update"
},
"methods": [
{
"name": "update",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -5066,33 +5463,11 @@
}
],
"description": "Update a database by its unique ID.",
+ "demo": "databases\/update.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateDatabase"
+ "replaceWith": "tablesDB.update"
}
- },
- {
- "name": "updateDatabase",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "name",
- "enabled"
- ],
- "required": [
- "databaseId",
- "name"
- ],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/database"
- }
- ],
- "description": "Update a database by its unique ID."
}
],
"auth": {
@@ -5158,7 +5533,7 @@
"x-appwrite": {
"method": "delete",
"group": "databases",
- "weight": 319,
+ "weight": 320,
"cookies": false,
"type": "",
"demo": "databases\/delete.md",
@@ -5173,12 +5548,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteDatabase"
+ "replaceWith": "tablesDB.delete"
},
"methods": [
{
"name": "delete",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -5194,29 +5570,11 @@
}
],
"description": "Delete a database by its unique ID. Only API keys with with databases.write scope can delete a database.",
+ "demo": "databases\/delete.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteDatabase"
+ "replaceWith": "tablesDB.delete"
}
- },
- {
- "name": "deleteDatabase",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId"
- ],
- "required": [
- "databaseId"
- ],
- "responses": [
- {
- "code": 204
- }
- ],
- "description": "Delete a database by its unique ID. Only API keys with with databases.write scope can delete a database."
}
],
"auth": {
@@ -5267,7 +5625,7 @@
"x-appwrite": {
"method": "listCollections",
"group": "collections",
- "weight": 328,
+ "weight": 329,
"cookies": false,
"type": "",
"demo": "databases\/list-collections.md",
@@ -5282,7 +5640,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listTables"
+ "replaceWith": "tablesDB.listTables"
},
"auth": {
"Project": []
@@ -5354,7 +5712,7 @@
"x-appwrite": {
"method": "createCollection",
"group": "collections",
- "weight": 324,
+ "weight": 325,
"cookies": false,
"type": "",
"demo": "databases\/create-collection.md",
@@ -5369,7 +5727,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createTable"
+ "replaceWith": "tablesDB.createTable"
},
"auth": {
"Project": []
@@ -5462,7 +5820,7 @@
"x-appwrite": {
"method": "getCollection",
"group": "collections",
- "weight": 325,
+ "weight": 326,
"cookies": false,
"type": "",
"demo": "databases\/get-collection.md",
@@ -5477,7 +5835,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getTable"
+ "replaceWith": "tablesDB.getTable"
},
"auth": {
"Project": []
@@ -5535,7 +5893,7 @@
"x-appwrite": {
"method": "updateCollection",
"group": "collections",
- "weight": 326,
+ "weight": 327,
"cookies": false,
"type": "",
"demo": "databases\/update-collection.md",
@@ -5550,7 +5908,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateTable"
+ "replaceWith": "tablesDB.updateTable"
},
"auth": {
"Project": []
@@ -5638,7 +5996,7 @@
"x-appwrite": {
"method": "deleteCollection",
"group": "collections",
- "weight": 327,
+ "weight": 328,
"cookies": false,
"type": "",
"demo": "databases\/delete-collection.md",
@@ -5653,7 +6011,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteTable"
+ "replaceWith": "tablesDB.deleteTable"
},
"auth": {
"Project": []
@@ -5713,7 +6071,7 @@
"x-appwrite": {
"method": "listAttributes",
"group": "attributes",
- "weight": 345,
+ "weight": 346,
"cookies": false,
"type": "",
"demo": "databases\/list-attributes.md",
@@ -5728,7 +6086,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listColumns"
+ "replaceWith": "tablesDB.listColumns"
},
"auth": {
"Project": []
@@ -5801,7 +6159,7 @@
"x-appwrite": {
"method": "createBooleanAttribute",
"group": "attributes",
- "weight": 346,
+ "weight": 347,
"cookies": false,
"type": "",
"demo": "databases\/create-boolean-attribute.md",
@@ -5816,7 +6174,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createBooleanColumn"
+ "replaceWith": "tablesDB.createBooleanColumn"
},
"auth": {
"Project": []
@@ -5911,7 +6269,7 @@
"x-appwrite": {
"method": "updateBooleanAttribute",
"group": "attributes",
- "weight": 347,
+ "weight": 348,
"cookies": false,
"type": "",
"demo": "databases\/update-boolean-attribute.md",
@@ -5926,7 +6284,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateBooleanColumn"
+ "replaceWith": "tablesDB.updateBooleanColumn"
},
"auth": {
"Project": []
@@ -6026,7 +6384,7 @@
"x-appwrite": {
"method": "createDatetimeAttribute",
"group": "attributes",
- "weight": 348,
+ "weight": 349,
"cookies": false,
"type": "",
"demo": "databases\/create-datetime-attribute.md",
@@ -6041,7 +6399,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createDatetimeColumn"
+ "replaceWith": "tablesDB.createDatetimeColumn"
},
"auth": {
"Project": []
@@ -6136,7 +6494,7 @@
"x-appwrite": {
"method": "updateDatetimeAttribute",
"group": "attributes",
- "weight": 349,
+ "weight": 350,
"cookies": false,
"type": "",
"demo": "databases\/update-datetime-attribute.md",
@@ -6151,7 +6509,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateDatetimeColumn"
+ "replaceWith": "tablesDB.updateDatetimeColumn"
},
"auth": {
"Project": []
@@ -6251,7 +6609,7 @@
"x-appwrite": {
"method": "createEmailAttribute",
"group": "attributes",
- "weight": 350,
+ "weight": 351,
"cookies": false,
"type": "",
"demo": "databases\/create-email-attribute.md",
@@ -6266,7 +6624,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createEmailColumn"
+ "replaceWith": "tablesDB.createEmailColumn"
},
"auth": {
"Project": []
@@ -6361,7 +6719,7 @@
"x-appwrite": {
"method": "updateEmailAttribute",
"group": "attributes",
- "weight": 351,
+ "weight": 352,
"cookies": false,
"type": "",
"demo": "databases\/update-email-attribute.md",
@@ -6376,7 +6734,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateEmailColumn"
+ "replaceWith": "tablesDB.updateEmailColumn"
},
"auth": {
"Project": []
@@ -6476,7 +6834,7 @@
"x-appwrite": {
"method": "createEnumAttribute",
"group": "attributes",
- "weight": 352,
+ "weight": 353,
"cookies": false,
"type": "",
"demo": "databases\/create-enum-attribute.md",
@@ -6491,7 +6849,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createEnumColumn"
+ "replaceWith": "tablesDB.createEnumColumn"
},
"auth": {
"Project": []
@@ -6595,7 +6953,7 @@
"x-appwrite": {
"method": "updateEnumAttribute",
"group": "attributes",
- "weight": 353,
+ "weight": 354,
"cookies": false,
"type": "",
"demo": "databases\/update-enum-attribute.md",
@@ -6610,7 +6968,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateEnumColumn"
+ "replaceWith": "tablesDB.updateEnumColumn"
},
"auth": {
"Project": []
@@ -6719,7 +7077,7 @@
"x-appwrite": {
"method": "createFloatAttribute",
"group": "attributes",
- "weight": 354,
+ "weight": 355,
"cookies": false,
"type": "",
"demo": "databases\/create-float-attribute.md",
@@ -6734,7 +7092,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createFloatColumn"
+ "replaceWith": "tablesDB.createFloatColumn"
},
"auth": {
"Project": []
@@ -6839,7 +7197,7 @@
"x-appwrite": {
"method": "updateFloatAttribute",
"group": "attributes",
- "weight": 355,
+ "weight": 356,
"cookies": false,
"type": "",
"demo": "databases\/update-float-attribute.md",
@@ -6854,7 +7212,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateFloatColumn"
+ "replaceWith": "tablesDB.updateFloatColumn"
},
"auth": {
"Project": []
@@ -6964,7 +7322,7 @@
"x-appwrite": {
"method": "createIntegerAttribute",
"group": "attributes",
- "weight": 356,
+ "weight": 357,
"cookies": false,
"type": "",
"demo": "databases\/create-integer-attribute.md",
@@ -6979,7 +7337,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createIntegerColumn"
+ "replaceWith": "tablesDB.createIntegerColumn"
},
"auth": {
"Project": []
@@ -7084,7 +7442,7 @@
"x-appwrite": {
"method": "updateIntegerAttribute",
"group": "attributes",
- "weight": 357,
+ "weight": 358,
"cookies": false,
"type": "",
"demo": "databases\/update-integer-attribute.md",
@@ -7099,7 +7457,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateIntegerColumn"
+ "replaceWith": "tablesDB.updateIntegerColumn"
},
"auth": {
"Project": []
@@ -7209,7 +7567,7 @@
"x-appwrite": {
"method": "createIpAttribute",
"group": "attributes",
- "weight": 358,
+ "weight": 359,
"cookies": false,
"type": "",
"demo": "databases\/create-ip-attribute.md",
@@ -7224,7 +7582,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createIpColumn"
+ "replaceWith": "tablesDB.createIpColumn"
},
"auth": {
"Project": []
@@ -7319,7 +7677,7 @@
"x-appwrite": {
"method": "updateIpAttribute",
"group": "attributes",
- "weight": 359,
+ "weight": 360,
"cookies": false,
"type": "",
"demo": "databases\/update-ip-attribute.md",
@@ -7334,7 +7692,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateIpColumn"
+ "replaceWith": "tablesDB.updateIpColumn"
},
"auth": {
"Project": []
@@ -7434,7 +7792,7 @@
"x-appwrite": {
"method": "createRelationshipAttribute",
"group": "attributes",
- "weight": 360,
+ "weight": 361,
"cookies": false,
"type": "",
"demo": "databases\/create-relationship-attribute.md",
@@ -7449,7 +7807,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRelationshipColumn"
+ "replaceWith": "tablesDB.createRelationshipColumn"
},
"auth": {
"Project": []
@@ -7569,7 +7927,7 @@
"x-appwrite": {
"method": "createStringAttribute",
"group": "attributes",
- "weight": 362,
+ "weight": 363,
"cookies": false,
"type": "",
"demo": "databases\/create-string-attribute.md",
@@ -7584,7 +7942,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createStringColumn"
+ "replaceWith": "tablesDB.createStringColumn"
},
"auth": {
"Project": []
@@ -7690,7 +8048,7 @@
"x-appwrite": {
"method": "updateStringAttribute",
"group": "attributes",
- "weight": 363,
+ "weight": 364,
"cookies": false,
"type": "",
"demo": "databases\/update-string-attribute.md",
@@ -7705,7 +8063,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateStringColumn"
+ "replaceWith": "tablesDB.updateStringColumn"
},
"auth": {
"Project": []
@@ -7810,7 +8168,7 @@
"x-appwrite": {
"method": "createUrlAttribute",
"group": "attributes",
- "weight": 364,
+ "weight": 365,
"cookies": false,
"type": "",
"demo": "databases\/create-url-attribute.md",
@@ -7825,7 +8183,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createUrlColumn"
+ "replaceWith": "tablesDB.createUrlColumn"
},
"auth": {
"Project": []
@@ -7920,7 +8278,7 @@
"x-appwrite": {
"method": "updateUrlAttribute",
"group": "attributes",
- "weight": 365,
+ "weight": 366,
"cookies": false,
"type": "",
"demo": "databases\/update-url-attribute.md",
@@ -7935,7 +8293,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateUrlColumn"
+ "replaceWith": "tablesDB.updateUrlColumn"
},
"auth": {
"Project": []
@@ -8066,7 +8424,7 @@
"x-appwrite": {
"method": "getAttribute",
"group": "attributes",
- "weight": 343,
+ "weight": 344,
"cookies": false,
"type": "",
"demo": "databases\/get-attribute.md",
@@ -8081,7 +8439,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getColumn"
+ "replaceWith": "tablesDB.getColumn"
},
"auth": {
"Project": []
@@ -8141,7 +8499,7 @@
"x-appwrite": {
"method": "deleteAttribute",
"group": "attributes",
- "weight": 344,
+ "weight": 345,
"cookies": false,
"type": "",
"demo": "databases\/delete-attribute.md",
@@ -8156,7 +8514,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteColumn"
+ "replaceWith": "tablesDB.deleteColumn"
},
"auth": {
"Project": []
@@ -8225,7 +8583,7 @@
"x-appwrite": {
"method": "updateRelationshipAttribute",
"group": "attributes",
- "weight": 361,
+ "weight": 362,
"cookies": false,
"type": "",
"demo": "databases\/update-relationship-attribute.md",
@@ -8240,7 +8598,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateRelationshipColumn"
+ "replaceWith": "tablesDB.updateRelationshipColumn"
},
"auth": {
"Project": []
@@ -8337,7 +8695,7 @@
"x-appwrite": {
"method": "listDocuments",
"group": "documents",
- "weight": 339,
+ "weight": 340,
"cookies": false,
"type": "",
"demo": "databases\/list-documents.md",
@@ -8354,7 +8712,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listRows"
+ "replaceWith": "tablesDB.listRows"
},
"auth": {
"Project": []
@@ -8426,7 +8784,7 @@
"x-appwrite": {
"method": "createDocument",
"group": "documents",
- "weight": 331,
+ "weight": 332,
"cookies": false,
"type": "",
"demo": "databases\/create-document.md",
@@ -8443,12 +8801,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRow"
+ "replaceWith": "tablesDB.createRow"
},
"methods": [
{
"name": "createDocument",
"namespace": "databases",
+ "desc": "Create document",
"auth": {
"Project": []
},
@@ -8472,14 +8831,16 @@
}
],
"description": "Create a new Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "demo": "databases\/create-document.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRow"
+ "replaceWith": "tablesDB.createRow"
}
},
{
"name": "createDocuments",
"namespace": "databases",
+ "desc": "Create documents",
"auth": {
"Project": []
},
@@ -8499,10 +8860,11 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "Create new Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "demo": "databases\/create-documents.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createRows"
+ "replaceWith": "tablesDB.createRows"
}
}
],
@@ -8578,12 +8940,12 @@
}
},
"put": {
- "summary": "Create or update documents",
+ "summary": "Upsert documents",
"operationId": "databasesUpsertDocuments",
"tags": [
"databases"
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
"responses": {
"201": {
"description": "Documents List",
@@ -8600,7 +8962,7 @@
"x-appwrite": {
"method": "upsertDocuments",
"group": "documents",
- "weight": 336,
+ "weight": 337,
"cookies": false,
"type": "",
"demo": "databases\/upsert-documents.md",
@@ -8616,12 +8978,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRows"
+ "replaceWith": "tablesDB.upsertRows"
},
"methods": [
{
"name": "upsertDocuments",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -8641,10 +9004,11 @@
"model": "#\/components\/schemas\/documentList"
}
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "description": "Create or update Documents. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.\n",
+ "demo": "databases\/upsert-documents.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRows"
+ "replaceWith": "tablesDB.upsertRows"
}
}
],
@@ -8709,7 +9073,7 @@
"tags": [
"databases"
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nUpdate all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
+ "description": "Update all documents that match your queries, if no queries are submitted then all documents are updated. You can pass only specific fields to be updated.",
"responses": {
"200": {
"description": "Documents List",
@@ -8726,7 +9090,7 @@
"x-appwrite": {
"method": "updateDocuments",
"group": "documents",
- "weight": 334,
+ "weight": 335,
"cookies": false,
"type": "",
"demo": "databases\/update-documents.md",
@@ -8742,7 +9106,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateRows"
+ "replaceWith": "tablesDB.updateRows"
},
"auth": {
"Project": []
@@ -8807,7 +9171,7 @@
"tags": [
"databases"
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nBulk delete documents using queries, if no queries are passed then all documents are deleted.",
+ "description": "Bulk delete documents using queries, if no queries are passed then all documents are deleted.",
"responses": {
"200": {
"description": "Documents List",
@@ -8824,7 +9188,7 @@
"x-appwrite": {
"method": "deleteDocuments",
"group": "documents",
- "weight": 338,
+ "weight": 339,
"cookies": false,
"type": "",
"demo": "databases\/delete-documents.md",
@@ -8840,7 +9204,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteRows"
+ "replaceWith": "tablesDB.deleteRows"
},
"auth": {
"Project": []
@@ -8919,7 +9283,7 @@
"x-appwrite": {
"method": "getDocument",
"group": "documents",
- "weight": 332,
+ "weight": 333,
"cookies": false,
"type": "",
"demo": "databases\/get-document.md",
@@ -8936,7 +9300,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getRow"
+ "replaceWith": "tablesDB.getRow"
},
"auth": {
"Project": []
@@ -8996,12 +9360,12 @@
]
},
"put": {
- "summary": "Create or update a document",
+ "summary": "Upsert a document",
"operationId": "databasesUpsertDocument",
"tags": [
"databases"
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
"responses": {
"201": {
"description": "Document",
@@ -9018,7 +9382,7 @@
"x-appwrite": {
"method": "upsertDocument",
"group": "documents",
- "weight": 335,
+ "weight": 336,
"cookies": false,
"type": "",
"demo": "databases\/upsert-document.md",
@@ -9035,12 +9399,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRow"
+ "replaceWith": "tablesDB.upsertRow"
},
"methods": [
{
"name": "upsertDocument",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -9063,10 +9428,11 @@
"model": "#\/components\/schemas\/document"
}
],
- "description": "**WARNING: Experimental Feature** - This endpoint is experimental and not yet officially supported. It may be subject to breaking changes or removal in future versions.\n\nCreate or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "description": "Create or update a Document. Before using this route, you should create a new collection resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateCollection) API or directly from your database console.",
+ "demo": "databases\/upsert-document.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.upsertRow"
+ "replaceWith": "tablesDB.upsertRow"
}
}
],
@@ -9164,7 +9530,7 @@
"x-appwrite": {
"method": "updateDocument",
"group": "documents",
- "weight": 333,
+ "weight": 334,
"cookies": false,
"type": "",
"demo": "databases\/update-document.md",
@@ -9181,7 +9547,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.updateRow"
+ "replaceWith": "tablesDB.updateRow"
},
"auth": {
"Project": []
@@ -9267,7 +9633,7 @@
"x-appwrite": {
"method": "deleteDocument",
"group": "documents",
- "weight": 337,
+ "weight": 338,
"cookies": false,
"type": "",
"demo": "databases\/delete-document.md",
@@ -9284,7 +9650,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteRow"
+ "replaceWith": "tablesDB.deleteRow"
},
"auth": {
"Project": []
@@ -9355,7 +9721,7 @@
"x-appwrite": {
"method": "listDocumentLogs",
"group": "logs",
- "weight": 340,
+ "weight": 341,
"cookies": false,
"type": "",
"demo": "databases\/list-document-logs.md",
@@ -9370,7 +9736,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listRowLogs"
+ "replaceWith": "tablesDB.listRowLogs"
},
"auth": {
"Project": []
@@ -9452,7 +9818,7 @@
"x-appwrite": {
"method": "decrementDocumentAttribute",
"group": "documents",
- "weight": 342,
+ "weight": 343,
"cookies": false,
"type": "",
"demo": "databases\/decrement-document-attribute.md",
@@ -9462,13 +9828,15 @@
"rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
"scope": "documents.write",
"platforms": [
+ "client",
+ "server",
"console",
"server"
],
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.decrementRowColumn"
+ "replaceWith": "tablesDB.decrementRowColumn"
},
"auth": {
"Project": []
@@ -9477,6 +9845,7 @@
"security": [
{
"Project": [],
+ "JWT": [],
"Key": []
}
],
@@ -9568,7 +9937,7 @@
"x-appwrite": {
"method": "incrementDocumentAttribute",
"group": "documents",
- "weight": 341,
+ "weight": 342,
"cookies": false,
"type": "",
"demo": "databases\/increment-document-attribute.md",
@@ -9578,13 +9947,15 @@
"rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
"scope": "documents.write",
"platforms": [
+ "client",
+ "server",
"console",
"server"
],
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.incrementRowColumn"
+ "replaceWith": "tablesDB.incrementRowColumn"
},
"auth": {
"Project": []
@@ -9593,6 +9964,7 @@
"security": [
{
"Project": [],
+ "JWT": [],
"Key": []
}
],
@@ -9684,7 +10056,7 @@
"x-appwrite": {
"method": "listIndexes",
"group": "indexes",
- "weight": 369,
+ "weight": 370,
"cookies": false,
"type": "",
"demo": "databases\/list-indexes.md",
@@ -9699,7 +10071,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listIndexes"
+ "replaceWith": "tablesDB.listIndexes"
},
"auth": {
"Project": []
@@ -9770,7 +10142,7 @@
"x-appwrite": {
"method": "createIndex",
"group": "indexes",
- "weight": 366,
+ "weight": 367,
"cookies": false,
"type": "",
"demo": "databases\/create-index.md",
@@ -9785,7 +10157,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.createIndex"
+ "replaceWith": "tablesDB.createIndex"
},
"auth": {
"Project": []
@@ -9902,7 +10274,7 @@
"x-appwrite": {
"method": "getIndex",
"group": "indexes",
- "weight": 367,
+ "weight": 368,
"cookies": false,
"type": "",
"demo": "databases\/get-index.md",
@@ -9917,7 +10289,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getIndex"
+ "replaceWith": "tablesDB.getIndex"
},
"auth": {
"Project": []
@@ -9977,7 +10349,7 @@
"x-appwrite": {
"method": "deleteIndex",
"group": "indexes",
- "weight": 368,
+ "weight": 369,
"cookies": false,
"type": "",
"demo": "databases\/delete-index.md",
@@ -9992,7 +10364,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.deleteIndex"
+ "replaceWith": "tablesDB.deleteIndex"
},
"auth": {
"Project": []
@@ -10061,7 +10433,7 @@
"x-appwrite": {
"method": "listCollectionLogs",
"group": "collections",
- "weight": 329,
+ "weight": 330,
"cookies": false,
"type": "",
"demo": "databases\/list-collection-logs.md",
@@ -10076,7 +10448,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listTableLogs"
+ "replaceWith": "tablesDB.listTableLogs"
},
"auth": {
"Project": []
@@ -10148,7 +10520,7 @@
"x-appwrite": {
"method": "getCollectionUsage",
"group": null,
- "weight": 330,
+ "weight": 331,
"cookies": false,
"type": "",
"demo": "databases\/get-collection-usage.md",
@@ -10163,7 +10535,7 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getTableUsage"
+ "replaceWith": "tablesDB.getTableUsage"
},
"auth": {
"Project": []
@@ -10197,7 +10569,7 @@
"30d",
"90d"
],
- "x-enum-name": "DatabaseUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -10220,4779 +10592,6 @@
]
}
},
- "\/databases\/{databaseId}\/grids\/tables": {
- "get": {
- "summary": "List tables",
- "operationId": "gridsListTables",
- "tags": [
- "grids"
- ],
- "description": "Get a list of all tables that belong to the provided databaseId. You can use the search parameter to filter your results.",
- "responses": {
- "200": {
- "description": "Tables List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/tableList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listTables",
- "group": null,
- "weight": 374,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-tables.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/list-tables.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, rowSecurity",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- },
- {
- "name": "search",
- "description": "Search term to filter your list results. Max length: 256 chars.",
- "required": false,
- "schema": {
- "type": "string",
- "x-example": "",
- "default": ""
- },
- "in": "query"
- }
- ]
- },
- "post": {
- "summary": "Create table",
- "operationId": "gridsCreateTable",
- "tags": [
- "grids"
- ],
- "description": "Create a new Table. Before using this route, you should create a new database resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.",
- "responses": {
- "201": {
- "description": "Table",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/table"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createTable",
- "group": null,
- "weight": 370,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-table.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-table.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "tableId": {
- "type": "string",
- "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
- "x-example": ""
- },
- "name": {
- "type": "string",
- "description": "Table name. Max length: 128 chars.",
- "x-example": ""
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- },
- "rowSecurity": {
- "type": "boolean",
- "description": "Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a row. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": false
- },
- "enabled": {
- "type": "boolean",
- "description": "Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.",
- "x-example": false
- }
- },
- "required": [
- "tableId",
- "name"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}": {
- "get": {
- "summary": "Get table",
- "operationId": "gridsGetTable",
- "tags": [
- "grids"
- ],
- "description": "Get a table by its unique ID. This endpoint response returns a JSON object with the table metadata.",
- "responses": {
- "200": {
- "description": "Table",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/table"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getTable",
- "group": null,
- "weight": 371,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-table.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-table.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ]
- },
- "put": {
- "summary": "Update table",
- "operationId": "gridsUpdateTable",
- "tags": [
- "grids"
- ],
- "description": "Update a table by its unique ID.",
- "responses": {
- "200": {
- "description": "Table",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/table"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateTable",
- "group": null,
- "weight": 372,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-table.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-table.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "name": {
- "type": "string",
- "description": "Table name. Max length: 128 chars.",
- "x-example": ""
- },
- "permissions": {
- "type": "array",
- "description": "An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- },
- "rowSecurity": {
- "type": "boolean",
- "description": "Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a document. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": false
- },
- "enabled": {
- "type": "boolean",
- "description": "Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.",
- "x-example": false
- }
- },
- "required": [
- "name"
- ]
- }
- }
- }
- }
- },
- "delete": {
- "summary": "Delete table",
- "operationId": "gridsDeleteTable",
- "tags": [
- "grids"
- ],
- "description": "Delete a table by its unique ID. Only users with write permissions have access to delete this resource.",
- "responses": {
- "204": {
- "description": "No content"
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteTable",
- "group": null,
- "weight": 373,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-table.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-table.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns": {
- "get": {
- "summary": "List columns",
- "operationId": "gridsListColumns",
- "tags": [
- "grids"
- ],
- "description": "List columns in the table.",
- "responses": {
- "200": {
- "description": "Columns List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listColumns",
- "group": "columns",
- "weight": 379,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-columns.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/list-columns.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: key, type, size, required, array, status, error",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/boolean": {
- "post": {
- "summary": "Create boolean column",
- "operationId": "gridsCreateBooleanColumn",
- "tags": [
- "grids"
- ],
- "description": "Create a boolean column.\n",
- "responses": {
- "202": {
- "description": "ColumnBoolean",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnBoolean"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createBooleanColumn",
- "group": "columns",
- "weight": 380,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-boolean-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-boolean-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "boolean",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": false
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/boolean\/{key}": {
- "patch": {
- "summary": "Update boolean column",
- "operationId": "gridsUpdateBooleanColumn",
- "tags": [
- "grids"
- ],
- "description": "Update a boolean column. Changing the `default` value will not update already existing rows.",
- "responses": {
- "200": {
- "description": "ColumnBoolean",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnBoolean"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateBooleanColumn",
- "group": "columns",
- "weight": 381,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-boolean-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-boolean-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "boolean",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": false,
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/datetime": {
- "post": {
- "summary": "Create datetime column",
- "operationId": "gridsCreateDatetimeColumn",
- "tags": [
- "grids"
- ],
- "description": "Create a date time column according to the ISO 8601 standard.",
- "responses": {
- "202": {
- "description": "ColumnDatetime",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnDatetime"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createDatetimeColumn",
- "group": "columns",
- "weight": 382,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-datetime-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-datetime-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for the column in [ISO 8601](https:\/\/www.iso.org\/iso-8601-date-and-time-format.html) format. Cannot be set when column is required.",
- "x-example": null
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/datetime\/{key}": {
- "patch": {
- "summary": "Update dateTime column",
- "operationId": "gridsUpdateDatetimeColumn",
- "tags": [
- "grids"
- ],
- "description": "Update a date time column. Changing the `default` value will not update already existing rows.",
- "responses": {
- "200": {
- "description": "ColumnDatetime",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnDatetime"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateDatetimeColumn",
- "group": "columns",
- "weight": 383,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-datetime-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-datetime-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": null,
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/email": {
- "post": {
- "summary": "Create email column",
- "operationId": "gridsCreateEmailColumn",
- "tags": [
- "grids"
- ],
- "description": "Create an email column.\n",
- "responses": {
- "202": {
- "description": "ColumnEmail",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnEmail"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createEmailColumn",
- "group": "columns",
- "weight": 384,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-email-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-email-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "email@example.com"
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/email\/{key}": {
- "patch": {
- "summary": "Update email column",
- "operationId": "gridsUpdateEmailColumn",
- "tags": [
- "grids"
- ],
- "description": "Update an email column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnEmail",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnEmail"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateEmailColumn",
- "group": "columns",
- "weight": 385,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-email-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-email-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "email@example.com",
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/enum": {
- "post": {
- "summary": "Create enum column",
- "operationId": "gridsCreateEnumColumn",
- "tags": [
- "grids"
- ],
- "description": "Create an enumeration column. The `elements` param acts as a white-list of accepted values for this column.",
- "responses": {
- "202": {
- "description": "ColumnEnum",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnEnum"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createEnumColumn",
- "group": "columns",
- "weight": 386,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-enum-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-enum-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "elements": {
- "type": "array",
- "description": "Array of enum values.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": ""
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "elements",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/enum\/{key}": {
- "patch": {
- "summary": "Update enum column",
- "operationId": "gridsUpdateEnumColumn",
- "tags": [
- "grids"
- ],
- "description": "Update an enum column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnEnum",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnEnum"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateEnumColumn",
- "group": "columns",
- "weight": 387,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-enum-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-enum-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "elements": {
- "type": "array",
- "description": "Updated list of enum values.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "",
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "elements",
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/float": {
- "post": {
- "summary": "Create float column",
- "operationId": "gridsCreateFloatColumn",
- "tags": [
- "grids"
- ],
- "description": "Create a float column. Optionally, minimum and maximum values can be provided.\n",
- "responses": {
- "202": {
- "description": "ColumnFloat",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnFloat"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createFloatColumn",
- "group": "columns",
- "weight": 388,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-float-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-float-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "min": {
- "type": "number",
- "description": "Minimum value",
- "x-example": null
- },
- "max": {
- "type": "number",
- "description": "Maximum value",
- "x-example": null
- },
- "default": {
- "type": "number",
- "description": "Default value. Cannot be set when required.",
- "x-example": null
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/float\/{key}": {
- "patch": {
- "summary": "Update float column",
- "operationId": "gridsUpdateFloatColumn",
- "tags": [
- "grids"
- ],
- "description": "Update a float column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnFloat",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnFloat"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateFloatColumn",
- "group": "columns",
- "weight": 389,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-float-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-float-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "min": {
- "type": "number",
- "description": "Minimum value",
- "x-example": null
- },
- "max": {
- "type": "number",
- "description": "Maximum value",
- "x-example": null
- },
- "default": {
- "type": "number",
- "description": "Default value. Cannot be set when required.",
- "x-example": null,
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/integer": {
- "post": {
- "summary": "Create integer column",
- "operationId": "gridsCreateIntegerColumn",
- "tags": [
- "grids"
- ],
- "description": "Create an integer column. Optionally, minimum and maximum values can be provided.\n",
- "responses": {
- "202": {
- "description": "ColumnInteger",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnInteger"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createIntegerColumn",
- "group": "columns",
- "weight": 390,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-integer-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-integer-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "min": {
- "type": "integer",
- "description": "Minimum value",
- "x-example": null
- },
- "max": {
- "type": "integer",
- "description": "Maximum value",
- "x-example": null
- },
- "default": {
- "type": "integer",
- "description": "Default value. Cannot be set when column is required.",
- "x-example": null
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/integer\/{key}": {
- "patch": {
- "summary": "Update integer column",
- "operationId": "gridsUpdateIntegerColumn",
- "tags": [
- "grids"
- ],
- "description": "Update an integer column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnInteger",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnInteger"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateIntegerColumn",
- "group": "columns",
- "weight": 391,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-integer-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-integer-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "min": {
- "type": "integer",
- "description": "Minimum value",
- "x-example": null
- },
- "max": {
- "type": "integer",
- "description": "Maximum value",
- "x-example": null
- },
- "default": {
- "type": "integer",
- "description": "Default value. Cannot be set when column is required.",
- "x-example": null,
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/ip": {
- "post": {
- "summary": "Create IP address column",
- "operationId": "gridsCreateIpColumn",
- "tags": [
- "grids"
- ],
- "description": "Create IP address column.\n",
- "responses": {
- "202": {
- "description": "ColumnIP",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnIp"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createIpColumn",
- "group": "columns",
- "weight": 392,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-ip-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-ip-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value. Cannot be set when column is required.",
- "x-example": null
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/ip\/{key}": {
- "patch": {
- "summary": "Update IP address column",
- "operationId": "gridsUpdateIpColumn",
- "tags": [
- "grids"
- ],
- "description": "Update an ip column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnIP",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnIp"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateIpColumn",
- "group": "columns",
- "weight": 393,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-ip-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-ip-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value. Cannot be set when column is required.",
- "x-example": null,
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/relationship": {
- "post": {
- "summary": "Create relationship column",
- "operationId": "gridsCreateRelationshipColumn",
- "tags": [
- "grids"
- ],
- "description": "Create relationship column. [Learn more about relationship columns](https:\/\/appwrite.io\/docs\/databases-relationships#relationship-columns).\n",
- "responses": {
- "202": {
- "description": "ColumnRelationship",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnRelationship"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createRelationshipColumn",
- "group": "columns",
- "weight": 394,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-relationship-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-relationship-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "relatedTableId": {
- "type": "string",
- "description": "Related Table ID.",
- "x-example": ""
- },
- "type": {
- "type": "string",
- "description": "Relation type",
- "x-example": "oneToOne",
- "enum": [
- "oneToOne",
- "manyToOne",
- "manyToMany",
- "oneToMany"
- ],
- "x-enum-name": "RelationshipType",
- "x-enum-keys": []
- },
- "twoWay": {
- "type": "boolean",
- "description": "Is Two Way?",
- "x-example": false
- },
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "twoWayKey": {
- "type": "string",
- "description": "Two Way Column Key.",
- "x-example": null
- },
- "onDelete": {
- "type": "string",
- "description": "Constraints option",
- "x-example": "cascade",
- "enum": [
- "cascade",
- "restrict",
- "setNull"
- ],
- "x-enum-name": "RelationMutate",
- "x-enum-keys": []
- }
- },
- "required": [
- "relatedTableId",
- "type"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/string": {
- "post": {
- "summary": "Create string column",
- "operationId": "gridsCreateStringColumn",
- "tags": [
- "grids"
- ],
- "description": "Create a string column.\n",
- "responses": {
- "202": {
- "description": "ColumnString",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnString"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createStringColumn",
- "group": "columns",
- "weight": 396,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-string-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-string-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "size": {
- "type": "integer",
- "description": "Attribute size for text attributes, in number of characters.",
- "x-example": 1
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": ""
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- },
- "encrypt": {
- "type": "boolean",
- "description": "Toggle encryption for the column. Encryption enhances security by not storing any plain text values in the database. However, encrypted columns cannot be queried.",
- "x-example": false
- }
- },
- "required": [
- "key",
- "size",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/string\/{key}": {
- "patch": {
- "summary": "Update string column",
- "operationId": "gridsUpdateStringColumn",
- "tags": [
- "grids"
- ],
- "description": "Update a string column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnString",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnString"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateStringColumn",
- "group": "columns",
- "weight": 397,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-string-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-string-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "",
- "x-nullable": true
- },
- "size": {
- "type": "integer",
- "description": "Maximum size of the string column.",
- "x-example": 1
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/url": {
- "post": {
- "summary": "Create URL column",
- "operationId": "gridsCreateUrlColumn",
- "tags": [
- "grids"
- ],
- "description": "Create a URL column.\n",
- "responses": {
- "202": {
- "description": "ColumnURL",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnUrl"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createUrlColumn",
- "group": "columns",
- "weight": 398,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-url-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-url-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Column Key.",
- "x-example": null
- },
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "https:\/\/example.com"
- },
- "array": {
- "type": "boolean",
- "description": "Is column an array?",
- "x-example": false
- }
- },
- "required": [
- "key",
- "required"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/url\/{key}": {
- "patch": {
- "summary": "Update URL column",
- "operationId": "gridsUpdateUrlColumn",
- "tags": [
- "grids"
- ],
- "description": "Update an url column. Changing the `default` value will not update already existing rows.\n",
- "responses": {
- "200": {
- "description": "ColumnURL",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnUrl"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateUrlColumn",
- "group": "columns",
- "weight": 399,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-url-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-url-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "required": {
- "type": "boolean",
- "description": "Is column required?",
- "x-example": false
- },
- "default": {
- "type": "string",
- "description": "Default value for column when not provided. Cannot be set when column is required.",
- "x-example": "https:\/\/example.com",
- "x-nullable": true
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- },
- "required": [
- "required",
- "default"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/{key}": {
- "get": {
- "summary": "Get column",
- "operationId": "gridsGetColumn",
- "tags": [
- "grids"
- ],
- "description": "Get column by ID.",
- "responses": {
- "200": {
- "description": "ColumnBoolean, or ColumnInteger, or ColumnFloat, or ColumnEmail, or ColumnEnum, or ColumnURL, or ColumnIP, or ColumnDatetime, or ColumnRelationship, or ColumnString",
- "content": {
- "application\/json": {
- "schema": {
- "oneOf": [
- {
- "$ref": "#\/components\/schemas\/columnBoolean"
- },
- {
- "$ref": "#\/components\/schemas\/columnInteger"
- },
- {
- "$ref": "#\/components\/schemas\/columnFloat"
- },
- {
- "$ref": "#\/components\/schemas\/columnEmail"
- },
- {
- "$ref": "#\/components\/schemas\/columnEnum"
- },
- {
- "$ref": "#\/components\/schemas\/columnUrl"
- },
- {
- "$ref": "#\/components\/schemas\/columnIp"
- },
- {
- "$ref": "#\/components\/schemas\/columnDatetime"
- },
- {
- "$ref": "#\/components\/schemas\/columnRelationship"
- },
- {
- "$ref": "#\/components\/schemas\/columnString"
- }
- ]
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getColumn",
- "group": "columns",
- "weight": 377,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ]
- },
- "delete": {
- "summary": "Delete column",
- "operationId": "gridsDeleteColumn",
- "tags": [
- "grids"
- ],
- "description": "Deletes a column.",
- "responses": {
- "204": {
- "description": "No content"
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteColumn",
- "group": "columns",
- "weight": 378,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/columns\/{key}\/relationship": {
- "patch": {
- "summary": "Update relationship column",
- "operationId": "gridsUpdateRelationshipColumn",
- "tags": [
- "grids"
- ],
- "description": "Update relationship column. [Learn more about relationship columns](https:\/\/appwrite.io\/docs\/databases-relationships#relationship-columns).\n",
- "responses": {
- "200": {
- "description": "ColumnRelationship",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnRelationship"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateRelationshipColumn",
- "group": "columns",
- "weight": 395,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-relationship-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-relationship-column.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Column Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "onDelete": {
- "type": "string",
- "description": "Constraints option",
- "x-example": "cascade",
- "enum": [
- "cascade",
- "restrict",
- "setNull"
- ],
- "x-enum-name": "RelationMutate",
- "x-enum-keys": []
- },
- "newKey": {
- "type": "string",
- "description": "New Column Key.",
- "x-example": null
- }
- }
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/indexes": {
- "get": {
- "summary": "List indexes",
- "operationId": "gridsListIndexes",
- "tags": [
- "grids"
- ],
- "description": "List indexes in the table.",
- "responses": {
- "200": {
- "description": "Column Indexes List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnIndexList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listIndexes",
- "group": "indexes",
- "weight": 403,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-indexes.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/list-indexes.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: key, type, status, attributes, error",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- },
- "post": {
- "summary": "Create index",
- "operationId": "gridsCreateIndex",
- "tags": [
- "grids"
- ],
- "description": "Creates an index on the columns listed. Your index should include all the columns you will query in a single request.\nColumns can be `key`, `fulltext`, and `unique`.",
- "responses": {
- "202": {
- "description": "Index",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnIndex"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createIndex",
- "group": "indexes",
- "weight": 400,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-index.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-index.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "key": {
- "type": "string",
- "description": "Index Key.",
- "x-example": null
- },
- "type": {
- "type": "string",
- "description": "Index type.",
- "x-example": "key",
- "enum": [
- "key",
- "fulltext",
- "unique"
- ],
- "x-enum-name": "IndexType",
- "x-enum-keys": []
- },
- "columns": {
- "type": "array",
- "description": "Array of columns to index. Maximum of 100 columns are allowed, each 32 characters long.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- },
- "orders": {
- "type": "array",
- "description": "Array of index orders. Maximum of 100 orders are allowed.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- },
- "lengths": {
- "type": "array",
- "description": "Length of index. Maximum of 100",
- "x-example": null,
- "items": {
- "type": "integer"
- }
- }
- },
- "required": [
- "key",
- "type",
- "columns"
- ]
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/indexes\/{key}": {
- "get": {
- "summary": "Get index",
- "operationId": "gridsGetIndex",
- "tags": [
- "grids"
- ],
- "description": "Get index by ID.",
- "responses": {
- "200": {
- "description": "Index",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/columnIndex"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getIndex",
- "group": "indexes",
- "weight": 401,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-index.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-index.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Index Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ]
- },
- "delete": {
- "summary": "Delete index",
- "operationId": "gridsDeleteIndex",
- "tags": [
- "grids"
- ],
- "description": "Delete an index.",
- "responses": {
- "204": {
- "description": "No content"
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteIndex",
- "group": "indexes",
- "weight": 402,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-index.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-index.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.write",
- "platforms": [
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "key",
- "description": "Index Key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/logs": {
- "get": {
- "summary": "List table logs",
- "operationId": "gridsListTableLogs",
- "tags": [
- "grids"
- ],
- "description": "Get the table activity logs list by its unique ID.",
- "responses": {
- "200": {
- "description": "Logs List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/logList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listTableLogs",
- "group": "tables",
- "weight": 375,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-table-logs.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-table-logs.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "console"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Only supported methods are limit and offset",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows": {
- "get": {
- "summary": "List rows",
- "operationId": "gridsListRows",
- "tags": [
- "grids"
- ],
- "description": "Get a list of all the user's rows in a given table. You can use the query params to filter your results.",
- "responses": {
- "200": {
- "description": "Rows List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/rowList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listRows",
- "group": "rows",
- "weight": 412,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-rows.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/list-rows.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "rows.read",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- },
- "post": {
- "summary": "Create row",
- "operationId": "gridsCreateRow",
- "tags": [
- "grids"
- ],
- "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.",
- "responses": {
- "201": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "createRow",
- "group": "rows",
- "weight": 404,
- "cookies": false,
- "type": "",
- "demo": "grids\/create-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/create-row.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "methods": [
- {
- "name": "createRow",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rowId",
- "data",
- "permissions"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rowId",
- "data"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/row"
- }
- ],
- "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console."
- },
- {
- "name": "createRows",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rows"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rows"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/rowList"
- }
- ],
- "description": "Create new Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console."
- }
- ],
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate). Make sure to define columns before creating rows.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "rowId": {
- "type": "string",
- "description": "Row ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
- "x-example": ""
- },
- "data": {
- "type": "object",
- "description": "Row data as JSON object.",
- "x-example": "{}"
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- },
- "rows": {
- "type": "array",
- "description": "Array of documents data as JSON objects.",
- "x-example": null,
- "items": {
- "type": "object"
- }
- }
- }
- }
- }
- }
- }
- },
- "put": {
- "summary": "Create or update rows",
- "operationId": "gridsUpsertRows",
- "tags": [
- "grids"
- ],
- "description": "Create or update Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.\n",
- "responses": {
- "201": {
- "description": "Rows List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/rowList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "upsertRows",
- "group": "rows",
- "weight": 409,
- "cookies": false,
- "type": "",
- "demo": "grids\/upsert-rows.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/upsert-rows.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "console",
- "server"
- ],
- "packaging": false,
- "methods": [
- {
- "name": "upsertRows",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rows"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rows"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/rowList"
- }
- ],
- "description": "Create or update Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.\n"
- }
- ],
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "rows": {
- "type": "array",
- "description": "Array of row data as JSON objects. May contain partial rows.",
- "x-example": null,
- "items": {
- "type": "object"
- }
- }
- },
- "required": [
- "rows"
- ]
- }
- }
- }
- }
- },
- "patch": {
- "summary": "Update rows",
- "operationId": "gridsUpdateRows",
- "tags": [
- "grids"
- ],
- "description": "Update all rows that match your queries, if no queries are submitted then all rows are updated. You can pass only specific fields to be updated.",
- "responses": {
- "200": {
- "description": "Rows List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/rowList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateRows",
- "group": "rows",
- "weight": 407,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-rows.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-rows.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "console",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "data": {
- "type": "object",
- "description": "Row data as JSON object. Include only column and value pairs to be updated.",
- "x-example": "{}"
- },
- "queries": {
- "type": "array",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- }
- }
- }
- }
- }
- }
- },
- "delete": {
- "summary": "Delete rows",
- "operationId": "gridsDeleteRows",
- "tags": [
- "grids"
- ],
- "description": "Bulk delete rows using queries, if no queries are passed then all rows are deleted.",
- "responses": {
- "200": {
- "description": "Rows List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/rowList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteRows",
- "group": "rows",
- "weight": 411,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-rows.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-rows.md",
- "rate-limit": 60,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "console",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "queries": {
- "type": "array",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "x-example": null,
- "items": {
- "type": "string"
- }
- }
- }
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows\/{rowId}": {
- "get": {
- "summary": "Get row",
- "operationId": "gridsGetRow",
- "tags": [
- "grids"
- ],
- "description": "Get a row by its unique ID. This endpoint response returns a JSON object with the row data.",
- "responses": {
- "200": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getRow",
- "group": "rows",
- "weight": 405,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-row.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "rows.read",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- },
- "put": {
- "summary": "Create or update a row",
- "operationId": "gridsUpsertRow",
- "tags": [
- "grids"
- ],
- "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console.",
- "responses": {
- "201": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "upsertRow",
- "group": "rows",
- "weight": 408,
- "cookies": false,
- "type": "",
- "demo": "grids\/upsert-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/upsert-row.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "methods": [
- {
- "name": "upsertRow",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "tableId",
- "rowId",
- "data",
- "permissions"
- ],
- "required": [
- "databaseId",
- "tableId",
- "rowId"
- ],
- "responses": [
- {
- "code": 201,
- "model": "#\/components\/schemas\/row"
- }
- ],
- "description": "Create or update a Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/databases#databasesCreateTable) API or directly from your database console."
- }
- ],
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "data": {
- "type": "object",
- "description": "Row data as JSON object. Include all required columns of the row to be created or updated.",
- "x-example": "{}"
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- }
- }
- }
- }
- }
- }
- },
- "patch": {
- "summary": "Update row",
- "operationId": "gridsUpdateRow",
- "tags": [
- "grids"
- ],
- "description": "Update a row by its unique ID. Using the patch method you can pass only specific fields that will get updated.",
- "responses": {
- "200": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "updateRow",
- "group": "rows",
- "weight": 406,
- "cookies": false,
- "type": "",
- "demo": "grids\/update-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/update-row.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "data": {
- "type": "object",
- "description": "Row data as JSON object. Include only columns and value pairs to be updated.",
- "x-example": "{}"
- },
- "permissions": {
- "type": "array",
- "description": "An array of permissions strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
- "x-example": "[\"read(\"any\")\"]",
- "items": {
- "type": "string"
- }
- }
- }
- }
- }
- }
- }
- },
- "delete": {
- "summary": "Delete row",
- "operationId": "gridsDeleteRow",
- "tags": [
- "grids"
- ],
- "description": "Delete a row by its unique ID.",
- "responses": {
- "204": {
- "description": "No content"
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "deleteRow",
- "group": "rows",
- "weight": 410,
- "cookies": false,
- "type": "",
- "demo": "grids\/delete-row.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/delete-row.md",
- "rate-limit": 60,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "client",
- "server",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": [],
- "JWT": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tables#tablesCreate).",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows\/{rowId}\/logs": {
- "get": {
- "summary": "List row logs",
- "operationId": "gridsListRowLogs",
- "tags": [
- "grids"
- ],
- "description": "Get the row activity logs list by its unique ID.",
- "responses": {
- "200": {
- "description": "Logs List",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/logList"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "listRowLogs",
- "group": "logs",
- "weight": 413,
- "cookies": false,
- "type": "",
- "demo": "grids\/list-row-logs.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-row-logs.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "rows.read",
- "platforms": [
- "console"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "queries",
- "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Only supported methods are limit and offset",
- "required": false,
- "schema": {
- "type": "array",
- "items": {
- "type": "string"
- },
- "default": []
- },
- "in": "query"
- }
- ]
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows\/{rowId}\/{column}\/decrement": {
- "patch": {
- "summary": "Decrement row column",
- "operationId": "gridsDecrementRowColumn",
- "tags": [
- "grids"
- ],
- "description": "Decrement a specific column of a row by a given value.",
- "responses": {
- "200": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "decrementRowColumn",
- "group": "rows",
- "weight": 415,
- "cookies": false,
- "type": "",
- "demo": "grids\/decrement-row-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/decrement-row-column.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "console",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "column",
- "description": "Column key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "value": {
- "type": "number",
- "description": "Value to increment the column by. The value must be a number.",
- "x-example": null
- },
- "min": {
- "type": "number",
- "description": "Minimum value for the column. If the current value is lesser than this value, an exception will be thrown.",
- "x-example": null
- }
- }
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/rows\/{rowId}\/{column}\/increment": {
- "patch": {
- "summary": "Increment row column",
- "operationId": "gridsIncrementRowColumn",
- "tags": [
- "grids"
- ],
- "description": "Increment a specific column of a row by a given value.",
- "responses": {
- "200": {
- "description": "Row",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/row"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "incrementRowColumn",
- "group": "rows",
- "weight": 414,
- "cookies": false,
- "type": "",
- "demo": "grids\/increment-row-column.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/increment-row-column.md",
- "rate-limit": 120,
- "rate-time": 60,
- "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
- "scope": "rows.write",
- "platforms": [
- "console",
- "server"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": [],
- "Key": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "rowId",
- "description": "Row ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "column",
- "description": "Column key.",
- "required": true,
- "schema": {
- "type": "string"
- },
- "in": "path"
- }
- ],
- "requestBody": {
- "content": {
- "application\/json": {
- "schema": {
- "type": "object",
- "properties": {
- "value": {
- "type": "number",
- "description": "Value to increment the column by. The value must be a number.",
- "x-example": null
- },
- "max": {
- "type": "number",
- "description": "Maximum value for the column. If the current value is greater than this value, an error will be thrown.",
- "x-example": null
- }
- }
- }
- }
- }
- }
- }
- },
- "\/databases\/{databaseId}\/grids\/tables\/{tableId}\/usage": {
- "get": {
- "summary": "Get table usage stats",
- "operationId": "gridsGetTableUsage",
- "tags": [
- "grids"
- ],
- "description": "Get usage metrics and statistics for a table. Returning the total number of rows. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
- "responses": {
- "200": {
- "description": "UsageTable",
- "content": {
- "application\/json": {
- "schema": {
- "$ref": "#\/components\/schemas\/usageTable"
- }
- }
- }
- }
- },
- "deprecated": false,
- "x-appwrite": {
- "method": "getTableUsage",
- "group": null,
- "weight": 376,
- "cookies": false,
- "type": "",
- "demo": "grids\/get-table-usage.md",
- "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/grids\/get-table-usage.md",
- "rate-limit": 0,
- "rate-time": 3600,
- "rate-key": "url:{url},ip:{ip}",
- "scope": "tables.read",
- "platforms": [
- "console"
- ],
- "packaging": false,
- "auth": {
- "Project": []
- }
- },
- "security": [
- {
- "Project": []
- }
- ],
- "parameters": [
- {
- "name": "databaseId",
- "description": "Database ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- },
- {
- "name": "range",
- "description": "Date range.",
- "required": false,
- "schema": {
- "type": "string",
- "x-example": "24h",
- "enum": [
- "24h",
- "30d",
- "90d"
- ],
- "x-enum-name": "GridUsageRange",
- "x-enum-keys": [
- "Twenty Four Hours",
- "Thirty Days",
- "Ninety Days"
- ],
- "default": "30d"
- },
- "in": "query"
- },
- {
- "name": "tableId",
- "description": "Table ID.",
- "required": true,
- "schema": {
- "type": "string",
- "x-example": ""
- },
- "in": "path"
- }
- ]
- }
- },
"\/databases\/{databaseId}\/logs": {
"get": {
"summary": "List database logs",
@@ -15017,7 +10616,7 @@
"x-appwrite": {
"method": "listLogs",
"group": "logs",
- "weight": 321,
+ "weight": 322,
"cookies": false,
"type": "",
"demo": "databases\/list-logs.md",
@@ -15032,12 +10631,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabaseLogs"
+ "replaceWith": "tablesDB.listDatabaseLogs"
},
"methods": [
{
"name": "listLogs",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -15055,31 +10655,11 @@
}
],
"description": "Get the database activity logs list by its unique ID.",
+ "demo": "databases\/list-logs.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.listDatabaseLogs"
+ "replaceWith": "tablesDB.listDatabaseLogs"
}
- },
- {
- "name": "listDatabaseLogs",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "queries"
- ],
- "required": [
- "databaseId"
- ],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/logList"
- }
- ],
- "description": ""
}
],
"auth": {
@@ -15121,7 +10701,7 @@
"\/databases\/{databaseId}\/usage": {
"get": {
"summary": "Get database usage stats",
- "operationId": "databasesGetDatabaseUsage",
+ "operationId": "databasesGetUsage",
"tags": [
"databases"
],
@@ -15140,12 +10720,12 @@
},
"deprecated": true,
"x-appwrite": {
- "method": "getDatabaseUsage",
+ "method": "getUsage",
"group": null,
- "weight": 322,
+ "weight": 323,
"cookies": false,
"type": "",
- "demo": "databases\/get-database-usage.md",
+ "demo": "databases\/get-usage.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/databases\/get-database-usage.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -15157,12 +10737,13 @@
"packaging": false,
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getDatabaseUsage"
+ "replaceWith": "tablesDB.getUsage"
},
"methods": [
{
- "name": "getDatabaseUsage",
+ "name": "getUsage",
"namespace": "databases",
+ "desc": "",
"auth": {
"Project": []
},
@@ -15180,31 +10761,11 @@
}
],
"description": "Get usage metrics and statistics for a database. You can view the total number of collections, documents, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "demo": "databases\/get-usage.md",
"deprecated": {
"since": "1.8.0",
- "replaceWith": "grids.getDatabaseUsage"
+ "replaceWith": "tablesDB.getUsage"
}
- },
- {
- "name": "getDatabaseUsage",
- "namespace": "grids",
- "auth": {
- "Project": []
- },
- "parameters": [
- "databaseId",
- "range"
- ],
- "required": [
- "databaseId"
- ],
- "responses": [
- {
- "code": 200,
- "model": "#\/components\/schemas\/usageDatabase"
- }
- ],
- "description": "Get usage metrics and statistics for a database. You can view the total number of tables, rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days."
}
],
"auth": {
@@ -15239,7 +10800,7 @@
"30d",
"90d"
],
- "x-enum-name": "DatabaseUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -15276,7 +10837,7 @@
"x-appwrite": {
"method": "list",
"group": "functions",
- "weight": 424,
+ "weight": 432,
"cookies": false,
"type": "",
"demo": "functions\/list.md",
@@ -15349,7 +10910,7 @@
"x-appwrite": {
"method": "create",
"group": "functions",
- "weight": 421,
+ "weight": 429,
"cookies": false,
"type": "",
"demo": "functions\/create.md",
@@ -15582,7 +11143,7 @@
"x-appwrite": {
"method": "listRuntimes",
"group": "runtimes",
- "weight": 426,
+ "weight": 434,
"cookies": false,
"type": "",
"demo": "functions\/list-runtimes.md",
@@ -15631,7 +11192,7 @@
"x-appwrite": {
"method": "listSpecifications",
"group": "runtimes",
- "weight": 427,
+ "weight": 435,
"cookies": false,
"type": "",
"demo": "functions\/list-specifications.md",
@@ -15681,7 +11242,7 @@
"x-appwrite": {
"method": "listTemplates",
"group": "templates",
- "weight": 450,
+ "weight": 458,
"cookies": false,
"type": "",
"demo": "functions\/list-templates.md",
@@ -15781,7 +11342,7 @@
"x-appwrite": {
"method": "getTemplate",
"group": "templates",
- "weight": 449,
+ "weight": 457,
"cookies": false,
"type": "",
"demo": "functions\/get-template.md",
@@ -15841,7 +11402,7 @@
"x-appwrite": {
"method": "listUsage",
"group": null,
- "weight": 443,
+ "weight": 451,
"cookies": false,
"type": "",
"demo": "functions\/list-usage.md",
@@ -15876,7 +11437,7 @@
"30d",
"90d"
],
- "x-enum-name": "FunctionUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -15913,7 +11474,7 @@
"x-appwrite": {
"method": "get",
"group": "functions",
- "weight": 422,
+ "weight": 430,
"cookies": false,
"type": "",
"demo": "functions\/get.md",
@@ -15972,7 +11533,7 @@
"x-appwrite": {
"method": "update",
"group": "functions",
- "weight": 423,
+ "weight": 431,
"cookies": false,
"type": "",
"demo": "functions\/update.md",
@@ -16202,7 +11763,7 @@
"x-appwrite": {
"method": "delete",
"group": "functions",
- "weight": 425,
+ "weight": 433,
"cookies": false,
"type": "",
"demo": "functions\/delete.md",
@@ -16263,7 +11824,7 @@
"x-appwrite": {
"method": "updateFunctionDeployment",
"group": "functions",
- "weight": 430,
+ "weight": 438,
"cookies": false,
"type": "",
"demo": "functions\/update-function-deployment.md",
@@ -16343,7 +11904,7 @@
"x-appwrite": {
"method": "listDeployments",
"group": "deployments",
- "weight": 431,
+ "weight": 439,
"cookies": false,
"type": "",
"demo": "functions\/list-deployments.md",
@@ -16426,7 +11987,7 @@
"x-appwrite": {
"method": "createDeployment",
"group": "deployments",
- "weight": 428,
+ "weight": 436,
"cookies": false,
"type": "upload",
"demo": "functions\/create-deployment.md",
@@ -16522,7 +12083,7 @@
"x-appwrite": {
"method": "createDuplicateDeployment",
"group": "deployments",
- "weight": 436,
+ "weight": 444,
"cookies": false,
"type": "",
"demo": "functions\/create-duplicate-deployment.md",
@@ -16607,7 +12168,7 @@
"x-appwrite": {
"method": "createTemplateDeployment",
"group": "deployments",
- "weight": 433,
+ "weight": 441,
"cookies": false,
"type": "",
"demo": "functions\/create-template-deployment.md",
@@ -16710,7 +12271,7 @@
"x-appwrite": {
"method": "createVcsDeployment",
"group": "deployments",
- "weight": 434,
+ "weight": 442,
"cookies": false,
"type": "",
"demo": "functions\/create-vcs-deployment.md",
@@ -16807,7 +12368,7 @@
"x-appwrite": {
"method": "getDeployment",
"group": "deployments",
- "weight": 429,
+ "weight": 437,
"cookies": false,
"type": "",
"demo": "functions\/get-deployment.md",
@@ -16869,7 +12430,7 @@
"x-appwrite": {
"method": "deleteDeployment",
"group": "deployments",
- "weight": 432,
+ "weight": 440,
"cookies": false,
"type": "",
"demo": "functions\/delete-deployment.md",
@@ -16933,7 +12494,7 @@
"x-appwrite": {
"method": "getDeploymentDownload",
"group": "deployments",
- "weight": 435,
+ "weight": 443,
"cookies": false,
"type": "location",
"demo": "functions\/get-deployment-download.md",
@@ -17023,7 +12584,7 @@
"x-appwrite": {
"method": "updateDeploymentStatus",
"group": "deployments",
- "weight": 437,
+ "weight": 445,
"cookies": false,
"type": "",
"demo": "functions\/update-deployment-status.md",
@@ -17094,7 +12655,7 @@
"x-appwrite": {
"method": "listExecutions",
"group": "executions",
- "weight": 440,
+ "weight": 448,
"cookies": false,
"type": "",
"demo": "functions\/list-executions.md",
@@ -17169,7 +12730,7 @@
"x-appwrite": {
"method": "createExecution",
"group": "executions",
- "weight": 438,
+ "weight": 446,
"cookies": false,
"type": "",
"demo": "functions\/create-execution.md",
@@ -17230,7 +12791,7 @@
},
"method": {
"type": "string",
- "description": "HTTP method of execution. Default value is GET.",
+ "description": "HTTP method of execution. Default value is POST.",
"x-example": "GET",
"enum": [
"GET",
@@ -17238,7 +12799,8 @@
"PUT",
"PATCH",
"DELETE",
- "OPTIONS"
+ "OPTIONS",
+ "HEAD"
],
"x-enum-name": "ExecutionMethod",
"x-enum-keys": []
@@ -17284,7 +12846,7 @@
"x-appwrite": {
"method": "getExecution",
"group": "executions",
- "weight": 439,
+ "weight": 447,
"cookies": false,
"type": "",
"demo": "functions\/get-execution.md",
@@ -17349,7 +12911,7 @@
"x-appwrite": {
"method": "deleteExecution",
"group": "executions",
- "weight": 441,
+ "weight": 449,
"cookies": false,
"type": "",
"demo": "functions\/delete-execution.md",
@@ -17420,7 +12982,7 @@
"x-appwrite": {
"method": "getUsage",
"group": null,
- "weight": 442,
+ "weight": 450,
"cookies": false,
"type": "",
"demo": "functions\/get-usage.md",
@@ -17465,7 +13027,7 @@
"30d",
"90d"
],
- "x-enum-name": "FunctionUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -17502,7 +13064,7 @@
"x-appwrite": {
"method": "listVariables",
"group": "variables",
- "weight": 446,
+ "weight": 454,
"cookies": false,
"type": "",
"demo": "functions\/list-variables.md",
@@ -17561,7 +13123,7 @@
"x-appwrite": {
"method": "createVariable",
"group": "variables",
- "weight": 444,
+ "weight": 452,
"cookies": false,
"type": "",
"demo": "functions\/create-variable.md",
@@ -17652,7 +13214,7 @@
"x-appwrite": {
"method": "getVariable",
"group": "variables",
- "weight": 445,
+ "weight": 453,
"cookies": false,
"type": "",
"demo": "functions\/get-variable.md",
@@ -17721,7 +13283,7 @@
"x-appwrite": {
"method": "updateVariable",
"group": "variables",
- "weight": 447,
+ "weight": 455,
"cookies": false,
"type": "",
"demo": "functions\/update-variable.md",
@@ -17812,7 +13374,7 @@
"x-appwrite": {
"method": "deleteVariable",
"group": "variables",
- "weight": 448,
+ "weight": 456,
"cookies": false,
"type": "",
"demo": "functions\/delete-variable.md",
@@ -17883,7 +13445,7 @@
"x-appwrite": {
"method": "query",
"group": "graphql",
- "weight": 254,
+ "weight": 255,
"cookies": false,
"type": "graphql",
"demo": "graphql\/query.md",
@@ -17935,7 +13497,7 @@
"x-appwrite": {
"method": "mutation",
"group": "graphql",
- "weight": 253,
+ "weight": 254,
"cookies": false,
"type": "graphql",
"demo": "graphql\/mutation.md",
@@ -18197,7 +13759,7 @@
"weight": 80,
"cookies": false,
"type": "",
- "demo": "health\/get-d-b.md",
+ "demo": "health\/get-db.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/health\/get-db.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -19493,7 +15055,7 @@
"weight": 73,
"cookies": false,
"type": "",
- "demo": "locale\/list-countries-e-u.md",
+ "demo": "locale\/list-countries-eu.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/locale\/list-countries-eu.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -19698,7 +15260,7 @@
"x-appwrite": {
"method": "listMessages",
"group": "messages",
- "weight": 308,
+ "weight": 309,
"cookies": false,
"type": "",
"demo": "messaging\/list-messages.md",
@@ -19774,7 +15336,7 @@
"x-appwrite": {
"method": "createEmail",
"group": "messages",
- "weight": 305,
+ "weight": 306,
"cookies": false,
"type": "",
"demo": "messaging\/create-email.md",
@@ -19918,7 +15480,7 @@
"x-appwrite": {
"method": "updateEmail",
"group": "messages",
- "weight": 312,
+ "weight": 313,
"cookies": false,
"type": "",
"demo": "messaging\/update-email.md",
@@ -20064,7 +15626,7 @@
"x-appwrite": {
"method": "createPush",
"group": "messages",
- "weight": 307,
+ "weight": 308,
"cookies": false,
"type": "",
"demo": "messaging\/create-push.md",
@@ -20238,7 +15800,7 @@
"x-appwrite": {
"method": "updatePush",
"group": "messages",
- "weight": 314,
+ "weight": 315,
"cookies": false,
"type": "",
"demo": "messaging\/update-push.md",
@@ -20412,11 +15974,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createSms",
"group": "messages",
- "weight": 306,
+ "weight": 307,
"cookies": false,
"type": "",
"demo": "messaging\/create-sms.md",
@@ -20430,6 +15992,74 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createSMS"
+ },
+ "methods": [
+ {
+ "name": "createSms",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "messageId",
+ "content",
+ "topics",
+ "users",
+ "targets",
+ "draft",
+ "scheduledAt"
+ ],
+ "required": [
+ "messageId",
+ "content"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/message"
+ }
+ ],
+ "description": "Create a new SMS message.",
+ "demo": "messaging\/create-sms.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createSMS"
+ }
+ },
+ {
+ "name": "createSMS",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "messageId",
+ "content",
+ "topics",
+ "users",
+ "targets",
+ "draft",
+ "scheduledAt"
+ ],
+ "required": [
+ "messageId",
+ "content"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/message"
+ }
+ ],
+ "description": "Create a new SMS message.",
+ "demo": "messaging\/create-sms.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -20521,11 +16151,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateSms",
"group": "messages",
- "weight": 313,
+ "weight": 314,
"cookies": false,
"type": "",
"demo": "messaging\/update-sms.md",
@@ -20539,6 +16169,72 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateSMS"
+ },
+ "methods": [
+ {
+ "name": "updateSms",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "messageId",
+ "topics",
+ "users",
+ "targets",
+ "content",
+ "draft",
+ "scheduledAt"
+ ],
+ "required": [
+ "messageId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/message"
+ }
+ ],
+ "description": "Update an SMS message by its unique ID. This endpoint only works on messages that are in draft status. Messages that are already processing, sent, or failed cannot be updated.\n",
+ "demo": "messaging\/update-sms.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateSMS"
+ }
+ },
+ {
+ "name": "updateSMS",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "messageId",
+ "topics",
+ "users",
+ "targets",
+ "content",
+ "draft",
+ "scheduledAt"
+ ],
+ "required": [
+ "messageId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/message"
+ }
+ ],
+ "description": "Update an SMS message by its unique ID. This endpoint only works on messages that are in draft status. Messages that are already processing, sent, or failed cannot be updated.\n",
+ "demo": "messaging\/update-sms.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -20637,7 +16333,7 @@
"x-appwrite": {
"method": "getMessage",
"group": "messages",
- "weight": 311,
+ "weight": 312,
"cookies": false,
"type": "",
"demo": "messaging\/get-message.md",
@@ -20690,7 +16386,7 @@
"x-appwrite": {
"method": "delete",
"group": "messages",
- "weight": 315,
+ "weight": 316,
"cookies": false,
"type": "",
"demo": "messaging\/delete.md",
@@ -20752,7 +16448,7 @@
"x-appwrite": {
"method": "listMessageLogs",
"group": "logs",
- "weight": 309,
+ "weight": 310,
"cookies": false,
"type": "",
"demo": "messaging\/list-message-logs.md",
@@ -20827,7 +16523,7 @@
"x-appwrite": {
"method": "listTargets",
"group": "messages",
- "weight": 310,
+ "weight": 311,
"cookies": false,
"type": "",
"demo": "messaging\/list-targets.md",
@@ -20902,7 +16598,7 @@
"x-appwrite": {
"method": "listProviders",
"group": "providers",
- "weight": 280,
+ "weight": 281,
"cookies": false,
"type": "",
"demo": "messaging\/list-providers.md",
@@ -20974,11 +16670,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createApnsProvider",
"group": "providers",
- "weight": 279,
+ "weight": 280,
"cookies": false,
"type": "",
"demo": "messaging\/create-apns-provider.md",
@@ -20992,6 +16688,76 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createAPNSProvider"
+ },
+ "methods": [
+ {
+ "name": "createApnsProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "authKey",
+ "authKeyId",
+ "teamId",
+ "bundleId",
+ "sandbox",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new Apple Push Notification service provider.",
+ "demo": "messaging\/create-apns-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createAPNSProvider"
+ }
+ },
+ {
+ "name": "createAPNSProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "authKey",
+ "authKeyId",
+ "teamId",
+ "bundleId",
+ "sandbox",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new Apple Push Notification service provider.",
+ "demo": "messaging\/create-apns-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -21079,11 +16845,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateApnsProvider",
"group": "providers",
- "weight": 292,
+ "weight": 293,
"cookies": false,
"type": "",
"demo": "messaging\/update-apns-provider.md",
@@ -21097,6 +16863,74 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateAPNSProvider"
+ },
+ "methods": [
+ {
+ "name": "updateApnsProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "enabled",
+ "authKey",
+ "authKeyId",
+ "teamId",
+ "bundleId",
+ "sandbox"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a Apple Push Notification service provider by its unique ID.",
+ "demo": "messaging\/update-apns-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateAPNSProvider"
+ }
+ },
+ {
+ "name": "updateAPNSProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "enabled",
+ "authKey",
+ "authKeyId",
+ "teamId",
+ "bundleId",
+ "sandbox"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a Apple Push Notification service provider by its unique ID.",
+ "demo": "messaging\/update-apns-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -21187,11 +17021,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createFcmProvider",
"group": "providers",
- "weight": 278,
+ "weight": 279,
"cookies": false,
"type": "",
"demo": "messaging\/create-fcm-provider.md",
@@ -21205,6 +17039,68 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createFCMProvider"
+ },
+ "methods": [
+ {
+ "name": "createFcmProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "serviceAccountJSON",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new Firebase Cloud Messaging provider.",
+ "demo": "messaging\/create-fcm-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createFCMProvider"
+ }
+ },
+ {
+ "name": "createFCMProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "serviceAccountJSON",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new Firebase Cloud Messaging provider.",
+ "demo": "messaging\/create-fcm-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -21272,11 +17168,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateFcmProvider",
"group": "providers",
- "weight": 291,
+ "weight": 292,
"cookies": false,
"type": "",
"demo": "messaging\/update-fcm-provider.md",
@@ -21290,6 +17186,66 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateFCMProvider"
+ },
+ "methods": [
+ {
+ "name": "updateFcmProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "enabled",
+ "serviceAccountJSON"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a Firebase Cloud Messaging provider by its unique ID.",
+ "demo": "messaging\/update-fcm-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateFCMProvider"
+ }
+ },
+ {
+ "name": "updateFCMProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "enabled",
+ "serviceAccountJSON"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a Firebase Cloud Messaging provider by its unique ID.",
+ "demo": "messaging\/update-fcm-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -21364,7 +17320,7 @@
"x-appwrite": {
"method": "createMailgunProvider",
"group": "providers",
- "weight": 270,
+ "weight": 271,
"cookies": false,
"type": "",
"demo": "messaging\/create-mailgun-provider.md",
@@ -21479,7 +17435,7 @@
"x-appwrite": {
"method": "updateMailgunProvider",
"group": "providers",
- "weight": 283,
+ "weight": 284,
"cookies": false,
"type": "",
"demo": "messaging\/update-mailgun-provider.md",
@@ -21597,10 +17553,10 @@
"x-appwrite": {
"method": "createMsg91Provider",
"group": "providers",
- "weight": 273,
+ "weight": 274,
"cookies": false,
"type": "",
- "demo": "messaging\/create-msg91provider.md",
+ "demo": "messaging\/create-msg-91-provider.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/messaging\/create-msg91-provider.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -21692,10 +17648,10 @@
"x-appwrite": {
"method": "updateMsg91Provider",
"group": "providers",
- "weight": 286,
+ "weight": 287,
"cookies": false,
"type": "",
- "demo": "messaging\/update-msg91provider.md",
+ "demo": "messaging\/update-msg-91-provider.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/messaging\/update-msg91-provider.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -21790,7 +17746,7 @@
"x-appwrite": {
"method": "createSendgridProvider",
"group": "providers",
- "weight": 271,
+ "weight": 272,
"cookies": false,
"type": "",
"demo": "messaging\/create-sendgrid-provider.md",
@@ -21895,7 +17851,7 @@
"x-appwrite": {
"method": "updateSendgridProvider",
"group": "providers",
- "weight": 284,
+ "weight": 285,
"cookies": false,
"type": "",
"demo": "messaging\/update-sendgrid-provider.md",
@@ -21999,11 +17955,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createSmtpProvider",
"group": "providers",
- "weight": 272,
+ "weight": 273,
"cookies": false,
"type": "",
"demo": "messaging\/create-smtp-provider.md",
@@ -22017,6 +17973,90 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createSMTPProvider"
+ },
+ "methods": [
+ {
+ "name": "createSmtpProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "host",
+ "port",
+ "username",
+ "password",
+ "encryption",
+ "autoTLS",
+ "mailer",
+ "fromName",
+ "fromEmail",
+ "replyToName",
+ "replyToEmail",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name",
+ "host"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new SMTP provider.",
+ "demo": "messaging\/create-smtp-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.createSMTPProvider"
+ }
+ },
+ {
+ "name": "createSMTPProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "host",
+ "port",
+ "username",
+ "password",
+ "encryption",
+ "autoTLS",
+ "mailer",
+ "fromName",
+ "fromEmail",
+ "replyToName",
+ "replyToEmail",
+ "enabled"
+ ],
+ "required": [
+ "providerId",
+ "name",
+ "host"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Create a new SMTP provider.",
+ "demo": "messaging\/create-smtp-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -22142,11 +18182,11 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateSmtpProvider",
"group": "providers",
- "weight": 285,
+ "weight": 286,
"cookies": false,
"type": "",
"demo": "messaging\/update-smtp-provider.md",
@@ -22160,6 +18200,86 @@
"server"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateSMTPProvider"
+ },
+ "methods": [
+ {
+ "name": "updateSmtpProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "host",
+ "port",
+ "username",
+ "password",
+ "encryption",
+ "autoTLS",
+ "mailer",
+ "fromName",
+ "fromEmail",
+ "replyToName",
+ "replyToEmail",
+ "enabled"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a SMTP provider by its unique ID.",
+ "demo": "messaging\/update-smtp-provider.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "messaging.updateSMTPProvider"
+ }
+ },
+ {
+ "name": "updateSMTPProvider",
+ "namespace": "messaging",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "providerId",
+ "name",
+ "host",
+ "port",
+ "username",
+ "password",
+ "encryption",
+ "autoTLS",
+ "mailer",
+ "fromName",
+ "fromEmail",
+ "replyToName",
+ "replyToEmail",
+ "enabled"
+ ],
+ "required": [
+ "providerId"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/provider"
+ }
+ ],
+ "description": "Update a SMTP provider by its unique ID.",
+ "demo": "messaging\/update-smtp-provider.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -22291,7 +18411,7 @@
"x-appwrite": {
"method": "createTelesignProvider",
"group": "providers",
- "weight": 274,
+ "weight": 275,
"cookies": false,
"type": "",
"demo": "messaging\/create-telesign-provider.md",
@@ -22386,7 +18506,7 @@
"x-appwrite": {
"method": "updateTelesignProvider",
"group": "providers",
- "weight": 287,
+ "weight": 288,
"cookies": false,
"type": "",
"demo": "messaging\/update-telesign-provider.md",
@@ -22484,7 +18604,7 @@
"x-appwrite": {
"method": "createTextmagicProvider",
"group": "providers",
- "weight": 275,
+ "weight": 276,
"cookies": false,
"type": "",
"demo": "messaging\/create-textmagic-provider.md",
@@ -22579,7 +18699,7 @@
"x-appwrite": {
"method": "updateTextmagicProvider",
"group": "providers",
- "weight": 288,
+ "weight": 289,
"cookies": false,
"type": "",
"demo": "messaging\/update-textmagic-provider.md",
@@ -22677,7 +18797,7 @@
"x-appwrite": {
"method": "createTwilioProvider",
"group": "providers",
- "weight": 276,
+ "weight": 277,
"cookies": false,
"type": "",
"demo": "messaging\/create-twilio-provider.md",
@@ -22772,7 +18892,7 @@
"x-appwrite": {
"method": "updateTwilioProvider",
"group": "providers",
- "weight": 289,
+ "weight": 290,
"cookies": false,
"type": "",
"demo": "messaging\/update-twilio-provider.md",
@@ -22870,7 +18990,7 @@
"x-appwrite": {
"method": "createVonageProvider",
"group": "providers",
- "weight": 277,
+ "weight": 278,
"cookies": false,
"type": "",
"demo": "messaging\/create-vonage-provider.md",
@@ -22965,7 +19085,7 @@
"x-appwrite": {
"method": "updateVonageProvider",
"group": "providers",
- "weight": 290,
+ "weight": 291,
"cookies": false,
"type": "",
"demo": "messaging\/update-vonage-provider.md",
@@ -23063,7 +19183,7 @@
"x-appwrite": {
"method": "getProvider",
"group": "providers",
- "weight": 282,
+ "weight": 283,
"cookies": false,
"type": "",
"demo": "messaging\/get-provider.md",
@@ -23116,7 +19236,7 @@
"x-appwrite": {
"method": "deleteProvider",
"group": "providers",
- "weight": 293,
+ "weight": 294,
"cookies": false,
"type": "",
"demo": "messaging\/delete-provider.md",
@@ -23178,7 +19298,7 @@
"x-appwrite": {
"method": "listProviderLogs",
"group": "providers",
- "weight": 281,
+ "weight": 282,
"cookies": false,
"type": "",
"demo": "messaging\/list-provider-logs.md",
@@ -23253,7 +19373,7 @@
"x-appwrite": {
"method": "listSubscriberLogs",
"group": "subscribers",
- "weight": 302,
+ "weight": 303,
"cookies": false,
"type": "",
"demo": "messaging\/list-subscriber-logs.md",
@@ -23328,7 +19448,7 @@
"x-appwrite": {
"method": "listTopics",
"group": "topics",
- "weight": 295,
+ "weight": 296,
"cookies": false,
"type": "",
"demo": "messaging\/list-topics.md",
@@ -23402,7 +19522,7 @@
"x-appwrite": {
"method": "createTopic",
"group": "topics",
- "weight": 294,
+ "weight": 295,
"cookies": false,
"type": "",
"demo": "messaging\/create-topic.md",
@@ -23485,7 +19605,7 @@
"x-appwrite": {
"method": "getTopic",
"group": "topics",
- "weight": 297,
+ "weight": 298,
"cookies": false,
"type": "",
"demo": "messaging\/get-topic.md",
@@ -23545,7 +19665,7 @@
"x-appwrite": {
"method": "updateTopic",
"group": "topics",
- "weight": 298,
+ "weight": 299,
"cookies": false,
"type": "",
"demo": "messaging\/update-topic.md",
@@ -23622,7 +19742,7 @@
"x-appwrite": {
"method": "deleteTopic",
"group": "topics",
- "weight": 299,
+ "weight": 300,
"cookies": false,
"type": "",
"demo": "messaging\/delete-topic.md",
@@ -23684,7 +19804,7 @@
"x-appwrite": {
"method": "listTopicLogs",
"group": "topics",
- "weight": 296,
+ "weight": 297,
"cookies": false,
"type": "",
"demo": "messaging\/list-topic-logs.md",
@@ -23759,7 +19879,7 @@
"x-appwrite": {
"method": "listSubscribers",
"group": "subscribers",
- "weight": 301,
+ "weight": 302,
"cookies": false,
"type": "",
"demo": "messaging\/list-subscribers.md",
@@ -23843,7 +19963,7 @@
"x-appwrite": {
"method": "createSubscriber",
"group": "subscribers",
- "weight": 300,
+ "weight": 301,
"cookies": false,
"type": "",
"demo": "messaging\/create-subscriber.md",
@@ -23933,7 +20053,7 @@
"x-appwrite": {
"method": "getSubscriber",
"group": "subscribers",
- "weight": 303,
+ "weight": 304,
"cookies": false,
"type": "",
"demo": "messaging\/get-subscriber.md",
@@ -23996,7 +20116,7 @@
"x-appwrite": {
"method": "deleteSubscriber",
"group": "subscribers",
- "weight": 304,
+ "weight": 305,
"cookies": false,
"type": "",
"demo": "messaging\/delete-subscriber.md",
@@ -24071,7 +20191,7 @@
"x-appwrite": {
"method": "list",
"group": null,
- "weight": 262,
+ "weight": 263,
"cookies": false,
"type": "",
"demo": "migrations\/list.md",
@@ -24145,7 +20265,7 @@
"x-appwrite": {
"method": "createAppwriteMigration",
"group": null,
- "weight": 257,
+ "weight": 258,
"cookies": false,
"type": "",
"demo": "migrations\/create-appwrite-migration.md",
@@ -24233,7 +20353,7 @@
"x-appwrite": {
"method": "getAppwriteReport",
"group": null,
- "weight": 264,
+ "weight": 265,
"cookies": false,
"type": "",
"demo": "migrations\/get-appwrite-report.md",
@@ -24326,7 +20446,7 @@
"x-appwrite": {
"method": "createCsvMigration",
"group": null,
- "weight": 261,
+ "weight": 262,
"cookies": false,
"type": "",
"demo": "migrations\/create-csv-migration.md",
@@ -24368,6 +20488,11 @@
"type": "string",
"description": "Composite ID in the format {databaseId:collectionId}, identifying a collection within a database.",
"x-example": "[ID1:ID2]"
+ },
+ "internalFile": {
+ "type": "boolean",
+ "description": "Is the file stored in an internal bucket?",
+ "x-example": false
}
},
"required": [
@@ -24405,7 +20530,7 @@
"x-appwrite": {
"method": "createFirebaseMigration",
"group": null,
- "weight": 258,
+ "weight": 259,
"cookies": false,
"type": "",
"demo": "migrations\/create-firebase-migration.md",
@@ -24481,7 +20606,7 @@
"x-appwrite": {
"method": "getFirebaseReport",
"group": null,
- "weight": 265,
+ "weight": 266,
"cookies": false,
"type": "",
"demo": "migrations\/get-firebase-report.md",
@@ -24553,7 +20678,7 @@
"x-appwrite": {
"method": "createNHostMigration",
"group": null,
- "weight": 260,
+ "weight": 261,
"cookies": false,
"type": "",
"demo": "migrations\/create-n-host-migration.md",
@@ -24664,7 +20789,7 @@
"x-appwrite": {
"method": "getNHostReport",
"group": null,
- "weight": 267,
+ "weight": 268,
"cookies": false,
"type": "",
"demo": "migrations\/get-n-host-report.md",
@@ -24797,7 +20922,7 @@
"x-appwrite": {
"method": "createSupabaseMigration",
"group": null,
- "weight": 259,
+ "weight": 260,
"cookies": false,
"type": "",
"demo": "migrations\/create-supabase-migration.md",
@@ -24902,7 +21027,7 @@
"x-appwrite": {
"method": "getSupabaseReport",
"group": null,
- "weight": 266,
+ "weight": 267,
"cookies": false,
"type": "",
"demo": "migrations\/get-supabase-report.md",
@@ -25026,7 +21151,7 @@
"x-appwrite": {
"method": "get",
"group": null,
- "weight": 263,
+ "weight": 264,
"cookies": false,
"type": "",
"demo": "migrations\/get.md",
@@ -25084,7 +21209,7 @@
"x-appwrite": {
"method": "retry",
"group": null,
- "weight": 268,
+ "weight": 269,
"cookies": false,
"type": "",
"demo": "migrations\/retry.md",
@@ -25135,7 +21260,7 @@
"x-appwrite": {
"method": "delete",
"group": null,
- "weight": 269,
+ "weight": 270,
"cookies": false,
"type": "",
"demo": "migrations\/delete.md",
@@ -26040,7 +22165,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateApiStatus",
"group": "projects",
@@ -26057,6 +22182,68 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateAPIStatus"
+ },
+ "methods": [
+ {
+ "name": "updateApiStatus",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "api",
+ "status"
+ ],
+ "required": [
+ "projectId",
+ "api",
+ "status"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the status of a specific API type. Use this endpoint to enable or disable API types such as REST, GraphQL and Realtime.",
+ "demo": "projects\/update-api-status.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateAPIStatus"
+ }
+ },
+ {
+ "name": "updateAPIStatus",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "api",
+ "status"
+ ],
+ "required": [
+ "projectId",
+ "api",
+ "status"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the status of a specific API type. Use this endpoint to enable or disable API types such as REST, GraphQL and Realtime.",
+ "demo": "projects\/update-api-status.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -26132,7 +22319,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateApiStatusAll",
"group": "projects",
@@ -26149,6 +22336,64 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateAPIStatusAll"
+ },
+ "methods": [
+ {
+ "name": "updateApiStatusAll",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "status"
+ ],
+ "required": [
+ "projectId",
+ "status"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the status of all API types. Use this endpoint to enable or disable API types such as REST, GraphQL and Realtime all at once.",
+ "demo": "projects\/update-api-status-all.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateAPIStatusAll"
+ }
+ },
+ {
+ "name": "updateAPIStatusAll",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "status"
+ ],
+ "required": [
+ "projectId",
+ "status"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the status of all API types. Use this endpoint to enable or disable API types such as REST, GraphQL and Realtime all at once.",
+ "demo": "projects\/update-api-status-all.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -27120,7 +23365,7 @@
"x-appwrite": {
"method": "listDevKeys",
"group": "devKeys",
- "weight": 419,
+ "weight": 427,
"cookies": false,
"type": "",
"demo": "projects\/list-dev-keys.md",
@@ -27188,7 +23433,7 @@
"x-appwrite": {
"method": "createDevKey",
"group": "devKeys",
- "weight": 416,
+ "weight": 424,
"cookies": false,
"type": "",
"demo": "projects\/create-dev-key.md",
@@ -27273,7 +23518,7 @@
"x-appwrite": {
"method": "getDevKey",
"group": "devKeys",
- "weight": 418,
+ "weight": 426,
"cookies": false,
"type": "",
"demo": "projects\/get-dev-key.md",
@@ -27341,7 +23586,7 @@
"x-appwrite": {
"method": "updateDevKey",
"group": "devKeys",
- "weight": 417,
+ "weight": 425,
"cookies": false,
"type": "",
"demo": "projects\/update-dev-key.md",
@@ -27427,7 +23672,7 @@
"x-appwrite": {
"method": "deleteDevKey",
"group": "devKeys",
- "weight": 420,
+ "weight": 428,
"cookies": false,
"type": "",
"demo": "projects\/delete-dev-key.md",
@@ -27500,7 +23745,7 @@
"weight": 134,
"cookies": false,
"type": "",
- "demo": "projects\/create-j-w-t.md",
+ "demo": "projects\/create-jwt.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/projects\/create-jwt.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -27970,7 +24215,7 @@
"weight": 111,
"cookies": false,
"type": "",
- "demo": "projects\/update-o-auth2.md",
+ "demo": "projects\/update-o-auth-2.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/projects\/update-oauth2.md",
"rate-limit": 0,
"rate-time": 3600,
@@ -28563,7 +24808,7 @@
"account",
"avatars",
"databases",
- "tables",
+ "tablesdb",
"locale",
"health",
"storage",
@@ -28692,7 +24937,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateSmtp",
"group": "templates",
@@ -28709,6 +24954,80 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateSMTP"
+ },
+ "methods": [
+ {
+ "name": "updateSmtp",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "enabled",
+ "senderName",
+ "senderEmail",
+ "replyTo",
+ "host",
+ "port",
+ "username",
+ "password",
+ "secure"
+ ],
+ "required": [
+ "projectId",
+ "enabled"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the SMTP configuration for your project. Use this endpoint to configure your project's SMTP provider with your custom settings for sending transactional emails. ",
+ "demo": "projects\/update-smtp.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateSMTP"
+ }
+ },
+ {
+ "name": "updateSMTP",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "enabled",
+ "senderName",
+ "senderEmail",
+ "replyTo",
+ "host",
+ "port",
+ "username",
+ "password",
+ "secure"
+ ],
+ "required": [
+ "projectId",
+ "enabled"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/project"
+ }
+ ],
+ "description": "Update the SMTP configuration for your project. Use this endpoint to configure your project's SMTP provider with your custom settings for sending transactional emails. ",
+ "demo": "projects\/update-smtp.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -28810,7 +25129,7 @@
"description": "No content"
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "createSmtpTest",
"group": "templates",
@@ -28827,6 +25146,84 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.createSMTPTest"
+ },
+ "methods": [
+ {
+ "name": "createSmtpTest",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "emails",
+ "senderName",
+ "senderEmail",
+ "replyTo",
+ "host",
+ "port",
+ "username",
+ "password",
+ "secure"
+ ],
+ "required": [
+ "projectId",
+ "emails",
+ "senderName",
+ "senderEmail",
+ "host"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Send a test email to verify SMTP configuration. ",
+ "demo": "projects\/create-smtp-test.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.createSMTPTest"
+ }
+ },
+ {
+ "name": "createSMTPTest",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "emails",
+ "senderName",
+ "senderEmail",
+ "replyTo",
+ "host",
+ "port",
+ "username",
+ "password",
+ "secure"
+ ],
+ "required": [
+ "projectId",
+ "emails",
+ "senderName",
+ "senderEmail",
+ "host"
+ ],
+ "responses": [
+ {
+ "code": 204
+ }
+ ],
+ "description": "Send a test email to verify SMTP configuration. ",
+ "demo": "projects\/create-smtp-test.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -29734,7 +26131,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "getSmsTemplate",
"group": "templates",
@@ -29751,6 +26148,68 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.getSMSTemplate"
+ },
+ "methods": [
+ {
+ "name": "getSmsTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Get a custom SMS template for the specified locale and type returning it's contents.",
+ "demo": "projects\/get-sms-template.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.getSMSTemplate"
+ }
+ },
+ {
+ "name": "getSMSTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Get a custom SMS template for the specified locale and type returning it's contents.",
+ "demo": "projects\/get-sms-template.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -29955,7 +26414,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "updateSmsTemplate",
"group": "templates",
@@ -29972,6 +26431,72 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateSMSTemplate"
+ },
+ "methods": [
+ {
+ "name": "updateSmsTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale",
+ "message"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale",
+ "message"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Update a custom SMS template for the specified locale and type. Use this endpoint to modify the content of your SMS templates. ",
+ "demo": "projects\/update-sms-template.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.updateSMSTemplate"
+ }
+ },
+ {
+ "name": "updateSMSTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale",
+ "message"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale",
+ "message"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Update a custom SMS template for the specified locale and type. Use this endpoint to modify the content of your SMS templates. ",
+ "demo": "projects\/update-sms-template.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -30195,7 +26720,7 @@
}
}
},
- "deprecated": false,
+ "deprecated": true,
"x-appwrite": {
"method": "deleteSmsTemplate",
"group": "templates",
@@ -30212,6 +26737,68 @@
"console"
],
"packaging": false,
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.deleteSMSTemplate"
+ },
+ "methods": [
+ {
+ "name": "deleteSmsTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Reset a custom SMS template to its default value. This endpoint removes any custom message and restores the template to its original state. ",
+ "demo": "projects\/delete-sms-template.md",
+ "deprecated": {
+ "since": "1.8.0",
+ "replaceWith": "projects.deleteSMSTemplate"
+ }
+ },
+ {
+ "name": "deleteSMSTemplate",
+ "namespace": "projects",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "required": [
+ "projectId",
+ "type",
+ "locale"
+ ],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/smsTemplate"
+ }
+ ],
+ "description": "Reset a custom SMS template to its default value. This endpoint removes any custom message and restores the template to its original state. ",
+ "demo": "projects\/delete-sms-template.md"
+ }
+ ],
"auth": {
"Project": []
}
@@ -30993,10 +27580,10 @@
"x-appwrite": {
"method": "createAPIRule",
"group": null,
- "weight": 481,
+ "weight": 489,
"cookies": false,
"type": "",
- "demo": "proxy\/create-a-p-i-rule.md",
+ "demo": "proxy\/create-api-rule.md",
"edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/masterCreate a new proxy rule for serving Appwrite's API on custom domain.",
"rate-limit": 10,
"rate-time": 60,
@@ -31060,7 +27647,7 @@
"x-appwrite": {
"method": "createFunctionRule",
"group": null,
- "weight": 483,
+ "weight": 491,
"cookies": false,
"type": "",
"demo": "proxy\/create-function-rule.md",
@@ -31138,7 +27725,7 @@
"x-appwrite": {
"method": "createRedirectRule",
"group": null,
- "weight": 484,
+ "weight": 492,
"cookies": false,
"type": "",
"demo": "proxy\/create-redirect-rule.md",
@@ -31251,7 +27838,7 @@
"x-appwrite": {
"method": "createSiteRule",
"group": null,
- "weight": 482,
+ "weight": 490,
"cookies": false,
"type": "",
"demo": "proxy\/create-site-rule.md",
@@ -31500,7 +28087,7 @@
"x-appwrite": {
"method": "list",
"group": "sites",
- "weight": 453,
+ "weight": 461,
"cookies": false,
"type": "",
"demo": "sites\/list.md",
@@ -31570,7 +28157,7 @@
"x-appwrite": {
"method": "create",
"group": "sites",
- "weight": 451,
+ "weight": 459,
"cookies": false,
"type": "",
"demo": "sites\/create.md",
@@ -31819,7 +28406,7 @@
"x-appwrite": {
"method": "listFrameworks",
"group": "frameworks",
- "weight": 456,
+ "weight": 464,
"cookies": false,
"type": "",
"demo": "sites\/list-frameworks.md",
@@ -31868,7 +28455,7 @@
"x-appwrite": {
"method": "listSpecifications",
"group": "frameworks",
- "weight": 479,
+ "weight": 487,
"cookies": false,
"type": "",
"demo": "sites\/list-specifications.md",
@@ -31918,7 +28505,7 @@
"x-appwrite": {
"method": "listTemplates",
"group": "templates",
- "weight": 475,
+ "weight": 483,
"cookies": false,
"type": "",
"demo": "sites\/list-templates.md",
@@ -32018,7 +28605,7 @@
"x-appwrite": {
"method": "getTemplate",
"group": "templates",
- "weight": 476,
+ "weight": 484,
"cookies": false,
"type": "",
"demo": "sites\/get-template.md",
@@ -32078,7 +28665,7 @@
"x-appwrite": {
"method": "listUsage",
"group": null,
- "weight": 477,
+ "weight": 485,
"cookies": false,
"type": "",
"demo": "sites\/list-usage.md",
@@ -32113,7 +28700,7 @@
"30d",
"90d"
],
- "x-enum-name": "SiteUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -32150,7 +28737,7 @@
"x-appwrite": {
"method": "get",
"group": "sites",
- "weight": 452,
+ "weight": 460,
"cookies": false,
"type": "",
"demo": "sites\/get.md",
@@ -32209,7 +28796,7 @@
"x-appwrite": {
"method": "update",
"group": "sites",
- "weight": 454,
+ "weight": 462,
"cookies": false,
"type": "",
"demo": "sites\/update.md",
@@ -32454,7 +29041,7 @@
"x-appwrite": {
"method": "delete",
"group": "sites",
- "weight": 455,
+ "weight": 463,
"cookies": false,
"type": "",
"demo": "sites\/delete.md",
@@ -32515,7 +29102,7 @@
"x-appwrite": {
"method": "updateSiteDeployment",
"group": "sites",
- "weight": 462,
+ "weight": 470,
"cookies": false,
"type": "",
"demo": "sites\/update-site-deployment.md",
@@ -32595,7 +29182,7 @@
"x-appwrite": {
"method": "listDeployments",
"group": "deployments",
- "weight": 461,
+ "weight": 469,
"cookies": false,
"type": "",
"demo": "sites\/list-deployments.md",
@@ -32678,7 +29265,7 @@
"x-appwrite": {
"method": "createDeployment",
"group": "deployments",
- "weight": 457,
+ "weight": 465,
"cookies": false,
"type": "upload",
"demo": "sites\/create-deployment.md",
@@ -32779,7 +29366,7 @@
"x-appwrite": {
"method": "createDuplicateDeployment",
"group": "deployments",
- "weight": 465,
+ "weight": 473,
"cookies": false,
"type": "",
"demo": "sites\/create-duplicate-deployment.md",
@@ -32859,7 +29446,7 @@
"x-appwrite": {
"method": "createTemplateDeployment",
"group": "deployments",
- "weight": 458,
+ "weight": 466,
"cookies": false,
"type": "",
"demo": "sites\/create-template-deployment.md",
@@ -32962,7 +29549,7 @@
"x-appwrite": {
"method": "createVcsDeployment",
"group": "deployments",
- "weight": 459,
+ "weight": 467,
"cookies": false,
"type": "",
"demo": "sites\/create-vcs-deployment.md",
@@ -33060,7 +29647,7 @@
"x-appwrite": {
"method": "getDeployment",
"group": "deployments",
- "weight": 460,
+ "weight": 468,
"cookies": false,
"type": "",
"demo": "sites\/get-deployment.md",
@@ -33122,7 +29709,7 @@
"x-appwrite": {
"method": "deleteDeployment",
"group": "deployments",
- "weight": 463,
+ "weight": 471,
"cookies": false,
"type": "",
"demo": "sites\/delete-deployment.md",
@@ -33186,7 +29773,7 @@
"x-appwrite": {
"method": "getDeploymentDownload",
"group": "deployments",
- "weight": 464,
+ "weight": 472,
"cookies": false,
"type": "location",
"demo": "sites\/get-deployment-download.md",
@@ -33276,7 +29863,7 @@
"x-appwrite": {
"method": "updateDeploymentStatus",
"group": "deployments",
- "weight": 466,
+ "weight": 474,
"cookies": false,
"type": "",
"demo": "sites\/update-deployment-status.md",
@@ -33347,7 +29934,7 @@
"x-appwrite": {
"method": "listLogs",
"group": "logs",
- "weight": 468,
+ "weight": 476,
"cookies": false,
"type": "",
"demo": "sites\/list-logs.md",
@@ -33418,7 +30005,7 @@
"x-appwrite": {
"method": "getLog",
"group": "logs",
- "weight": 467,
+ "weight": 475,
"cookies": false,
"type": "",
"demo": "sites\/get-log.md",
@@ -33480,7 +30067,7 @@
"x-appwrite": {
"method": "deleteLog",
"group": "logs",
- "weight": 469,
+ "weight": 477,
"cookies": false,
"type": "",
"demo": "sites\/delete-log.md",
@@ -33551,7 +30138,7 @@
"x-appwrite": {
"method": "getUsage",
"group": null,
- "weight": 478,
+ "weight": 486,
"cookies": false,
"type": "",
"demo": "sites\/get-usage.md",
@@ -33596,7 +30183,7 @@
"30d",
"90d"
],
- "x-enum-name": "SiteUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -33633,7 +30220,7 @@
"x-appwrite": {
"method": "listVariables",
"group": "variables",
- "weight": 472,
+ "weight": 480,
"cookies": false,
"type": "",
"demo": "sites\/list-variables.md",
@@ -33692,7 +30279,7 @@
"x-appwrite": {
"method": "createVariable",
"group": "variables",
- "weight": 470,
+ "weight": 478,
"cookies": false,
"type": "",
"demo": "sites\/create-variable.md",
@@ -33783,7 +30370,7 @@
"x-appwrite": {
"method": "getVariable",
"group": "variables",
- "weight": 471,
+ "weight": 479,
"cookies": false,
"type": "",
"demo": "sites\/get-variable.md",
@@ -33852,7 +30439,7 @@
"x-appwrite": {
"method": "updateVariable",
"group": "variables",
- "weight": 473,
+ "weight": 481,
"cookies": false,
"type": "",
"demo": "sites\/update-variable.md",
@@ -33943,7 +30530,7 @@
"x-appwrite": {
"method": "deleteVariable",
"group": "variables",
- "weight": 474,
+ "weight": 482,
"cookies": false,
"type": "",
"demo": "sites\/delete-variable.md",
@@ -35296,7 +31883,7 @@
"30d",
"90d"
],
- "x-enum-name": "StorageUsageRange",
+ "x-enum-name": "UsageRange",
"x-enum-keys": [
"Twenty Four Hours",
"Thirty Days",
@@ -35378,7 +31965,5487 @@
"30d",
"90d"
],
- "x-enum-name": "StorageUsageRange",
+ "x-enum-name": "UsageRange",
+ "x-enum-keys": [
+ "Twenty Four Hours",
+ "Thirty Days",
+ "Ninety Days"
+ ],
+ "default": "30d"
+ },
+ "in": "query"
+ }
+ ]
+ }
+ },
+ "\/tablesdb": {
+ "get": {
+ "summary": "List databases",
+ "operationId": "tablesDBList",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a list of all databases from the current Appwrite project. You can use the search parameter to filter your results.",
+ "responses": {
+ "200": {
+ "description": "Databases List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/databaseList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "list",
+ "group": "tablesdb",
+ "weight": 375,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": "databases.read",
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following columns: name",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ },
+ {
+ "name": "search",
+ "description": "Search term to filter your list results. Max length: 256 chars.",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "x-example": "",
+ "default": ""
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "post": {
+ "summary": "Create database",
+ "operationId": "tablesDBCreate",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a new Database.\n",
+ "responses": {
+ "201": {
+ "description": "Database",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/database"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "create",
+ "group": "tablesdb",
+ "weight": 371,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": "databases.write",
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "databaseId": {
+ "type": "string",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "x-example": ""
+ },
+ "name": {
+ "type": "string",
+ "description": "Database name. Max length: 128 chars.",
+ "x-example": ""
+ },
+ "enabled": {
+ "type": "boolean",
+ "description": "Is the database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.",
+ "x-example": false
+ }
+ },
+ "required": [
+ "databaseId",
+ "name"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/usage": {
+ "get": {
+ "summary": "Get TablesDB usage stats",
+ "operationId": "tablesDBListUsage",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, tables, rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "responses": {
+ "200": {
+ "description": "UsageDatabases",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/usageDatabases"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listUsage",
+ "group": null,
+ "weight": 377,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-usage.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-usage.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "console"
+ ],
+ "packaging": false,
+ "methods": [
+ {
+ "name": "listUsage",
+ "namespace": "tablesDB",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "range"
+ ],
+ "required": [],
+ "responses": [
+ {
+ "code": 200,
+ "model": "#\/components\/schemas\/usageDatabases"
+ }
+ ],
+ "description": "List usage metrics and statistics for all databases in the project. You can view the total number of databases, tables, rows, and storage usage. The response includes both current totals and historical data over time. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, range defaults to 30 days.",
+ "demo": "tablesdb\/list-usage.md"
+ }
+ ],
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "range",
+ "description": "Date range.",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "x-example": "24h",
+ "enum": [
+ "24h",
+ "30d",
+ "90d"
+ ],
+ "x-enum-name": "UsageRange",
+ "x-enum-keys": [
+ "Twenty Four Hours",
+ "Thirty Days",
+ "Ninety Days"
+ ],
+ "default": "30d"
+ },
+ "in": "query"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}": {
+ "get": {
+ "summary": "Get database",
+ "operationId": "tablesDBGet",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a database by its unique ID. This endpoint response returns a JSON object with the database metadata.",
+ "responses": {
+ "200": {
+ "description": "Database",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/database"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "get",
+ "group": "tablesdb",
+ "weight": 372,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/get.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": "databases.read",
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ]
+ },
+ "put": {
+ "summary": "Update database",
+ "operationId": "tablesDBUpdate",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a database by its unique ID.",
+ "responses": {
+ "200": {
+ "description": "Database",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/database"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "update",
+ "group": "tablesdb",
+ "weight": 373,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": "databases.write",
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "Database name. Max length: 128 chars.",
+ "x-example": ""
+ },
+ "enabled": {
+ "type": "boolean",
+ "description": "Is database enabled? When set to 'disabled', users cannot access the database but Server SDKs with an API key can still read and write to the database. No data is lost when this is toggled.",
+ "x-example": false
+ }
+ },
+ "required": [
+ "name"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "summary": "Delete database",
+ "operationId": "tablesDBDelete",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Delete a database by its unique ID. Only API keys with with databases.write scope can delete a database.",
+ "responses": {
+ "204": {
+ "description": "No content"
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "delete",
+ "group": "tablesdb",
+ "weight": 374,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/delete.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/delete.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": "databases.write",
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables": {
+ "get": {
+ "summary": "List tables",
+ "operationId": "tablesDBListTables",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a list of all tables that belong to the provided databaseId. You can use the search parameter to filter your results.",
+ "responses": {
+ "200": {
+ "description": "Tables List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/tableList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listTables",
+ "group": "tables",
+ "weight": 382,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-tables.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-tables.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following columns: name, enabled, rowSecurity",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ },
+ {
+ "name": "search",
+ "description": "Search term to filter your list results. Max length: 256 chars.",
+ "required": false,
+ "schema": {
+ "type": "string",
+ "x-example": "",
+ "default": ""
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "post": {
+ "summary": "Create table",
+ "operationId": "tablesDBCreateTable",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a new Table. Before using this route, you should create a new database resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "responses": {
+ "201": {
+ "description": "Table",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/table"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createTable",
+ "group": "tables",
+ "weight": 378,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-table.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-table.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "tableId": {
+ "type": "string",
+ "description": "Unique Id. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "x-example": ""
+ },
+ "name": {
+ "type": "string",
+ "description": "Table name. Max length: 128 chars.",
+ "x-example": ""
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permissions strings. By default, no user is granted with any permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ },
+ "rowSecurity": {
+ "type": "boolean",
+ "description": "Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a row. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": false
+ },
+ "enabled": {
+ "type": "boolean",
+ "description": "Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.",
+ "x-example": false
+ }
+ },
+ "required": [
+ "tableId",
+ "name"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}": {
+ "get": {
+ "summary": "Get table",
+ "operationId": "tablesDBGetTable",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a table by its unique ID. This endpoint response returns a JSON object with the table metadata.",
+ "responses": {
+ "200": {
+ "description": "Table",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/table"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "getTable",
+ "group": "tables",
+ "weight": 379,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/get-table.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get-table.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ]
+ },
+ "put": {
+ "summary": "Update table",
+ "operationId": "tablesDBUpdateTable",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a table by its unique ID.",
+ "responses": {
+ "200": {
+ "description": "Table",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/table"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateTable",
+ "group": "tables",
+ "weight": 380,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-table.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-table.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "name": {
+ "type": "string",
+ "description": "Table name. Max length: 128 chars.",
+ "x-example": ""
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permission strings. By default, the current permissions are inherited. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ },
+ "rowSecurity": {
+ "type": "boolean",
+ "description": "Enables configuring permissions for individual rows. A user needs one of row or table level permissions to access a document. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": false
+ },
+ "enabled": {
+ "type": "boolean",
+ "description": "Is table enabled? When set to 'disabled', users cannot access the table but Server SDKs with and API key can still read and write to the table. No data is lost when this is toggled.",
+ "x-example": false
+ }
+ },
+ "required": [
+ "name"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "delete": {
+ "summary": "Delete table",
+ "operationId": "tablesDBDeleteTable",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Delete a table by its unique ID. Only users with write permissions have access to delete this resource.",
+ "responses": {
+ "204": {
+ "description": "No content"
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "deleteTable",
+ "group": "tables",
+ "weight": 381,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/delete-table.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/delete-table.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns": {
+ "get": {
+ "summary": "List columns",
+ "operationId": "tablesDBListColumns",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "List columns in the table.",
+ "responses": {
+ "200": {
+ "description": "Columns List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listColumns",
+ "group": "columns",
+ "weight": 387,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-columns.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-columns.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following columns: key, type, size, required, array, status, error",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/boolean": {
+ "post": {
+ "summary": "Create boolean column",
+ "operationId": "tablesDBCreateBooleanColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a boolean column.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnBoolean",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnBoolean"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createBooleanColumn",
+ "group": "columns",
+ "weight": 388,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-boolean-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-boolean-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "boolean",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": false
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/boolean\/{key}": {
+ "patch": {
+ "summary": "Update boolean column",
+ "operationId": "tablesDBUpdateBooleanColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a boolean column. Changing the `default` value will not update already existing rows.",
+ "responses": {
+ "200": {
+ "description": "ColumnBoolean",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnBoolean"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateBooleanColumn",
+ "group": "columns",
+ "weight": 389,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-boolean-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-boolean-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "boolean",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": false,
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/datetime": {
+ "post": {
+ "summary": "Create datetime column",
+ "operationId": "tablesDBCreateDatetimeColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a date time column according to the ISO 8601 standard.",
+ "responses": {
+ "202": {
+ "description": "ColumnDatetime",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnDatetime"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createDatetimeColumn",
+ "group": "columns",
+ "weight": 390,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-datetime-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-datetime-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for the column in [ISO 8601](https:\/\/www.iso.org\/iso-8601-date-and-time-format.html) format. Cannot be set when column is required.",
+ "x-example": null
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/datetime\/{key}": {
+ "patch": {
+ "summary": "Update dateTime column",
+ "operationId": "tablesDBUpdateDatetimeColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a date time column. Changing the `default` value will not update already existing rows.",
+ "responses": {
+ "200": {
+ "description": "ColumnDatetime",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnDatetime"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateDatetimeColumn",
+ "group": "columns",
+ "weight": 391,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-datetime-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-datetime-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": null,
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/email": {
+ "post": {
+ "summary": "Create email column",
+ "operationId": "tablesDBCreateEmailColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create an email column.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnEmail",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnEmail"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createEmailColumn",
+ "group": "columns",
+ "weight": 392,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-email-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-email-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "email@example.com"
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/email\/{key}": {
+ "patch": {
+ "summary": "Update email column",
+ "operationId": "tablesDBUpdateEmailColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update an email column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnEmail",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnEmail"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateEmailColumn",
+ "group": "columns",
+ "weight": 393,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-email-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-email-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "email@example.com",
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/enum": {
+ "post": {
+ "summary": "Create enum column",
+ "operationId": "tablesDBCreateEnumColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create an enumeration column. The `elements` param acts as a white-list of accepted values for this column.",
+ "responses": {
+ "202": {
+ "description": "ColumnEnum",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnEnum"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createEnumColumn",
+ "group": "columns",
+ "weight": 394,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-enum-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-enum-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "elements": {
+ "type": "array",
+ "description": "Array of enum values.",
+ "x-example": null,
+ "items": {
+ "type": "string"
+ }
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": ""
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "elements",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/enum\/{key}": {
+ "patch": {
+ "summary": "Update enum column",
+ "operationId": "tablesDBUpdateEnumColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update an enum column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnEnum",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnEnum"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateEnumColumn",
+ "group": "columns",
+ "weight": 395,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-enum-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-enum-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "elements": {
+ "type": "array",
+ "description": "Updated list of enum values.",
+ "x-example": null,
+ "items": {
+ "type": "string"
+ }
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "",
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "elements",
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/float": {
+ "post": {
+ "summary": "Create float column",
+ "operationId": "tablesDBCreateFloatColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a float column. Optionally, minimum and maximum values can be provided.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnFloat",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnFloat"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createFloatColumn",
+ "group": "columns",
+ "weight": 396,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-float-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-float-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "min": {
+ "type": "number",
+ "description": "Minimum value",
+ "x-example": null
+ },
+ "max": {
+ "type": "number",
+ "description": "Maximum value",
+ "x-example": null
+ },
+ "default": {
+ "type": "number",
+ "description": "Default value. Cannot be set when required.",
+ "x-example": null
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/float\/{key}": {
+ "patch": {
+ "summary": "Update float column",
+ "operationId": "tablesDBUpdateFloatColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a float column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnFloat",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnFloat"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateFloatColumn",
+ "group": "columns",
+ "weight": 397,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-float-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-float-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "min": {
+ "type": "number",
+ "description": "Minimum value",
+ "x-example": null
+ },
+ "max": {
+ "type": "number",
+ "description": "Maximum value",
+ "x-example": null
+ },
+ "default": {
+ "type": "number",
+ "description": "Default value. Cannot be set when required.",
+ "x-example": null,
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/integer": {
+ "post": {
+ "summary": "Create integer column",
+ "operationId": "tablesDBCreateIntegerColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create an integer column. Optionally, minimum and maximum values can be provided.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnInteger",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnInteger"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createIntegerColumn",
+ "group": "columns",
+ "weight": 398,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-integer-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-integer-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "min": {
+ "type": "integer",
+ "description": "Minimum value",
+ "x-example": null
+ },
+ "max": {
+ "type": "integer",
+ "description": "Maximum value",
+ "x-example": null
+ },
+ "default": {
+ "type": "integer",
+ "description": "Default value. Cannot be set when column is required.",
+ "x-example": null
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/integer\/{key}": {
+ "patch": {
+ "summary": "Update integer column",
+ "operationId": "tablesDBUpdateIntegerColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update an integer column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnInteger",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnInteger"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateIntegerColumn",
+ "group": "columns",
+ "weight": 399,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-integer-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-integer-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "min": {
+ "type": "integer",
+ "description": "Minimum value",
+ "x-example": null
+ },
+ "max": {
+ "type": "integer",
+ "description": "Maximum value",
+ "x-example": null
+ },
+ "default": {
+ "type": "integer",
+ "description": "Default value. Cannot be set when column is required.",
+ "x-example": null,
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/ip": {
+ "post": {
+ "summary": "Create IP address column",
+ "operationId": "tablesDBCreateIpColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create IP address column.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnIP",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnIp"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createIpColumn",
+ "group": "columns",
+ "weight": 400,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-ip-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-ip-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value. Cannot be set when column is required.",
+ "x-example": null
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/ip\/{key}": {
+ "patch": {
+ "summary": "Update IP address column",
+ "operationId": "tablesDBUpdateIpColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update an ip column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnIP",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnIp"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateIpColumn",
+ "group": "columns",
+ "weight": 401,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-ip-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-ip-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value. Cannot be set when column is required.",
+ "x-example": null,
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/relationship": {
+ "post": {
+ "summary": "Create relationship column",
+ "operationId": "tablesDBCreateRelationshipColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create relationship column. [Learn more about relationship columns](https:\/\/appwrite.io\/docs\/databases-relationships#relationship-columns).\n",
+ "responses": {
+ "202": {
+ "description": "ColumnRelationship",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnRelationship"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createRelationshipColumn",
+ "group": "columns",
+ "weight": 402,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-relationship-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-relationship-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "relatedTableId": {
+ "type": "string",
+ "description": "Related Table ID.",
+ "x-example": ""
+ },
+ "type": {
+ "type": "string",
+ "description": "Relation type",
+ "x-example": "oneToOne",
+ "enum": [
+ "oneToOne",
+ "manyToOne",
+ "manyToMany",
+ "oneToMany"
+ ],
+ "x-enum-name": "RelationshipType",
+ "x-enum-keys": []
+ },
+ "twoWay": {
+ "type": "boolean",
+ "description": "Is Two Way?",
+ "x-example": false
+ },
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "twoWayKey": {
+ "type": "string",
+ "description": "Two Way Column Key.",
+ "x-example": null
+ },
+ "onDelete": {
+ "type": "string",
+ "description": "Constraints option",
+ "x-example": "cascade",
+ "enum": [
+ "cascade",
+ "restrict",
+ "setNull"
+ ],
+ "x-enum-name": "RelationMutate",
+ "x-enum-keys": []
+ }
+ },
+ "required": [
+ "relatedTableId",
+ "type"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/string": {
+ "post": {
+ "summary": "Create string column",
+ "operationId": "tablesDBCreateStringColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a string column.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnString",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnString"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createStringColumn",
+ "group": "columns",
+ "weight": 404,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-string-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-string-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "size": {
+ "type": "integer",
+ "description": "Column size for text columns, in number of characters.",
+ "x-example": 1
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": ""
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ },
+ "encrypt": {
+ "type": "boolean",
+ "description": "Toggle encryption for the column. Encryption enhances security by not storing any plain text values in the database. However, encrypted columns cannot be queried.",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "size",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/string\/{key}": {
+ "patch": {
+ "summary": "Update string column",
+ "operationId": "tablesDBUpdateStringColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update a string column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnString",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnString"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateStringColumn",
+ "group": "columns",
+ "weight": 405,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-string-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-string-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "",
+ "x-nullable": true
+ },
+ "size": {
+ "type": "integer",
+ "description": "Maximum size of the string column.",
+ "x-example": 1
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/url": {
+ "post": {
+ "summary": "Create URL column",
+ "operationId": "tablesDBCreateUrlColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a URL column.\n",
+ "responses": {
+ "202": {
+ "description": "ColumnURL",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnUrl"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createUrlColumn",
+ "group": "columns",
+ "weight": 406,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-url-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-url-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Column Key.",
+ "x-example": null
+ },
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "https:\/\/example.com"
+ },
+ "array": {
+ "type": "boolean",
+ "description": "Is column an array?",
+ "x-example": false
+ }
+ },
+ "required": [
+ "key",
+ "required"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/url\/{key}": {
+ "patch": {
+ "summary": "Update URL column",
+ "operationId": "tablesDBUpdateUrlColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update an url column. Changing the `default` value will not update already existing rows.\n",
+ "responses": {
+ "200": {
+ "description": "ColumnURL",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnUrl"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateUrlColumn",
+ "group": "columns",
+ "weight": 407,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-url-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-url-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "required": {
+ "type": "boolean",
+ "description": "Is column required?",
+ "x-example": false
+ },
+ "default": {
+ "type": "string",
+ "description": "Default value for column when not provided. Cannot be set when column is required.",
+ "x-example": "https:\/\/example.com",
+ "x-nullable": true
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ },
+ "required": [
+ "required",
+ "default"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/{key}": {
+ "get": {
+ "summary": "Get column",
+ "operationId": "tablesDBGetColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get column by ID.",
+ "responses": {
+ "200": {
+ "description": "ColumnBoolean, or ColumnInteger, or ColumnFloat, or ColumnEmail, or ColumnEnum, or ColumnURL, or ColumnIP, or ColumnDatetime, or ColumnRelationship, or ColumnString",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "oneOf": [
+ {
+ "$ref": "#\/components\/schemas\/columnBoolean"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnInteger"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnFloat"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnEmail"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnEnum"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnUrl"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnIp"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnDatetime"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnRelationship"
+ },
+ {
+ "$ref": "#\/components\/schemas\/columnString"
+ }
+ ]
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "getColumn",
+ "group": "columns",
+ "weight": 385,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/get-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ]
+ },
+ "delete": {
+ "summary": "Delete column",
+ "operationId": "tablesDBDeleteColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Deletes a column.",
+ "responses": {
+ "204": {
+ "description": "No content"
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "deleteColumn",
+ "group": "columns",
+ "weight": 386,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/delete-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/delete-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/columns\/{key}\/relationship": {
+ "patch": {
+ "summary": "Update relationship column",
+ "operationId": "tablesDBUpdateRelationshipColumn",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update relationship column. [Learn more about relationship columns](https:\/\/appwrite.io\/docs\/databases-relationships#relationship-columns).\n",
+ "responses": {
+ "200": {
+ "description": "ColumnRelationship",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnRelationship"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateRelationshipColumn",
+ "group": "columns",
+ "weight": 403,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-relationship-column.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-relationship-column.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Column Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "onDelete": {
+ "type": "string",
+ "description": "Constraints option",
+ "x-example": "cascade",
+ "enum": [
+ "cascade",
+ "restrict",
+ "setNull"
+ ],
+ "x-enum-name": "RelationMutate",
+ "x-enum-keys": []
+ },
+ "newKey": {
+ "type": "string",
+ "description": "New Column Key.",
+ "x-example": null
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/indexes": {
+ "get": {
+ "summary": "List indexes",
+ "operationId": "tablesDBListIndexes",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "List indexes on the table.",
+ "responses": {
+ "200": {
+ "description": "Column Indexes List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnIndexList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listIndexes",
+ "group": "indexes",
+ "weight": 411,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-indexes.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-indexes.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following columns: key, type, status, attributes, error",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "post": {
+ "summary": "Create index",
+ "operationId": "tablesDBCreateIndex",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Creates an index on the columns listed. Your index should include all the columns you will query in a single request.\nType can be `key`, `fulltext`, or `unique`.",
+ "responses": {
+ "202": {
+ "description": "Index",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnIndex"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createIndex",
+ "group": "indexes",
+ "weight": 408,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-index.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-index.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "key": {
+ "type": "string",
+ "description": "Index Key.",
+ "x-example": null
+ },
+ "type": {
+ "type": "string",
+ "description": "Index type.",
+ "x-example": "key",
+ "enum": [
+ "key",
+ "fulltext",
+ "unique"
+ ],
+ "x-enum-name": "IndexType",
+ "x-enum-keys": []
+ },
+ "columns": {
+ "type": "array",
+ "description": "Array of columns to index. Maximum of 100 columns are allowed, each 32 characters long.",
+ "x-example": null,
+ "items": {
+ "type": "string"
+ }
+ },
+ "orders": {
+ "type": "array",
+ "description": "Array of index orders. Maximum of 100 orders are allowed.",
+ "x-example": null,
+ "items": {
+ "type": "string"
+ }
+ },
+ "lengths": {
+ "type": "array",
+ "description": "Length of index. Maximum of 100",
+ "x-example": null,
+ "items": {
+ "type": "integer"
+ }
+ }
+ },
+ "required": [
+ "key",
+ "type",
+ "columns"
+ ]
+ }
+ }
+ }
+ }
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/indexes\/{key}": {
+ "get": {
+ "summary": "Get index",
+ "operationId": "tablesDBGetIndex",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get index by ID.",
+ "responses": {
+ "200": {
+ "description": "Index",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/columnIndex"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "getIndex",
+ "group": "indexes",
+ "weight": 409,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/get-index.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get-index.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Index Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ]
+ },
+ "delete": {
+ "summary": "Delete index",
+ "operationId": "tablesDBDeleteIndex",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Delete an index.",
+ "responses": {
+ "204": {
+ "description": "No content"
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "deleteIndex",
+ "group": "indexes",
+ "weight": 410,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/delete-index.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/delete-index.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.write",
+ "collections.write"
+ ],
+ "platforms": [
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "key",
+ "description": "Index Key.",
+ "required": true,
+ "schema": {
+ "type": "string"
+ },
+ "in": "path"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/logs": {
+ "get": {
+ "summary": "List table logs",
+ "operationId": "tablesDBListTableLogs",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get the table activity logs list by its unique ID.",
+ "responses": {
+ "200": {
+ "description": "Logs List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/logList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listTableLogs",
+ "group": "tables",
+ "weight": 383,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-table-logs.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/get-table-logs.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "tables.read",
+ "collections.read"
+ ],
+ "platforms": [
+ "console"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Only supported methods are limit and offset",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ }
+ },
+ "\/tablesdb\/{databaseId}\/tables\/{tableId}\/rows": {
+ "get": {
+ "summary": "List rows",
+ "operationId": "tablesDBListRows",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Get a list of all the user's rows in a given table. You can use the query params to filter your results.",
+ "responses": {
+ "200": {
+ "description": "Rows List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/rowList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "listRows",
+ "group": "rows",
+ "weight": 420,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/list-rows.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/list-rows.md",
+ "rate-limit": 0,
+ "rate-time": 3600,
+ "rate-key": "url:{url},ip:{ip}",
+ "scope": [
+ "rows.read",
+ "documents.read"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the TableDB service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdbdb#tablesdbCreate).",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "queries",
+ "description": "Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https:\/\/appwrite.io\/docs\/queries). Maximum of 100 queries are allowed, each 4096 characters long.",
+ "required": false,
+ "schema": {
+ "type": "array",
+ "items": {
+ "type": "string"
+ },
+ "default": []
+ },
+ "in": "query"
+ }
+ ]
+ },
+ "post": {
+ "summary": "Create row",
+ "operationId": "tablesDBCreateRow",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "responses": {
+ "201": {
+ "description": "Row",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/row"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "createRow",
+ "group": "rows",
+ "weight": 412,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/create-row.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/create-row.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "client",
+ "server",
+ "server"
+ ],
+ "packaging": false,
+ "methods": [
+ {
+ "name": "createRow",
+ "namespace": "tablesDB",
+ "desc": "Create row",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "databaseId",
+ "tableId",
+ "rowId",
+ "data",
+ "permissions"
+ ],
+ "required": [
+ "databaseId",
+ "tableId",
+ "rowId",
+ "data"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/row"
+ }
+ ],
+ "description": "Create a new Row. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "demo": "tablesdb\/create-row.md"
+ },
+ {
+ "name": "createRows",
+ "namespace": "tablesDB",
+ "desc": "Create rows",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "databaseId",
+ "tableId",
+ "rows"
+ ],
+ "required": [
+ "databaseId",
+ "tableId",
+ "rows"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/rowList"
+ }
+ ],
+ "description": "Create new Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.",
+ "demo": "tablesdb\/create-rows.md"
+ }
+ ],
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": [],
+ "JWT": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID. You can create a new table using the Database service [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreate). Make sure to define columns before creating rows.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "rowId": {
+ "type": "string",
+ "description": "Row ID. Choose a custom ID or generate a random ID with `ID.unique()`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.",
+ "x-example": ""
+ },
+ "data": {
+ "type": "object",
+ "description": "Row data as JSON object.",
+ "x-example": "{}"
+ },
+ "permissions": {
+ "type": "array",
+ "description": "An array of permissions strings. By default, only the current user is granted all permissions. [Learn more about permissions](https:\/\/appwrite.io\/docs\/permissions).",
+ "x-example": "[\"read(\"any\")\"]",
+ "items": {
+ "type": "string"
+ }
+ },
+ "rows": {
+ "type": "array",
+ "description": "Array of documents data as JSON objects.",
+ "x-example": null,
+ "items": {
+ "type": "object"
+ }
+ }
+ }
+ }
+ }
+ }
+ }
+ },
+ "put": {
+ "summary": "Upsert rows",
+ "operationId": "tablesDBUpsertRows",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Create or update Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.\n",
+ "responses": {
+ "201": {
+ "description": "Rows List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/rowList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "upsertRows",
+ "group": "rows",
+ "weight": 417,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/upsert-rows.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/upsert-rows.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "console",
+ "server"
+ ],
+ "packaging": false,
+ "methods": [
+ {
+ "name": "upsertRows",
+ "namespace": "tablesDB",
+ "desc": "",
+ "auth": {
+ "Project": []
+ },
+ "parameters": [
+ "databaseId",
+ "tableId",
+ "rows"
+ ],
+ "required": [
+ "databaseId",
+ "tableId",
+ "rows"
+ ],
+ "responses": [
+ {
+ "code": 201,
+ "model": "#\/components\/schemas\/rowList"
+ }
+ ],
+ "description": "Create or update Rows. Before using this route, you should create a new table resource using either a [server integration](https:\/\/appwrite.io\/docs\/server\/tablesdb#tablesDBCreateTable) API or directly from your database console.\n",
+ "demo": "tablesdb\/upsert-rows.md"
+ }
+ ],
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ }
+ ],
+ "requestBody": {
+ "content": {
+ "application\/json": {
+ "schema": {
+ "type": "object",
+ "properties": {
+ "rows": {
+ "type": "array",
+ "description": "Array of row data as JSON objects. May contain partial rows.",
+ "x-example": null,
+ "items": {
+ "type": "object"
+ }
+ }
+ },
+ "required": [
+ "rows"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "patch": {
+ "summary": "Update rows",
+ "operationId": "tablesDBUpdateRows",
+ "tags": [
+ "tablesDB"
+ ],
+ "description": "Update all rows that match your queries, if no queries are submitted then all rows are updated. You can pass only specific fields to be updated.",
+ "responses": {
+ "200": {
+ "description": "Rows List",
+ "content": {
+ "application\/json": {
+ "schema": {
+ "$ref": "#\/components\/schemas\/rowList"
+ }
+ }
+ }
+ }
+ },
+ "deprecated": false,
+ "x-appwrite": {
+ "method": "updateRows",
+ "group": "rows",
+ "weight": 415,
+ "cookies": false,
+ "type": "",
+ "demo": "tablesdb\/update-rows.md",
+ "edit": "https:\/\/github.com\/appwrite\/appwrite\/edit\/master\/docs\/references\/tablesdb\/update-rows.md",
+ "rate-limit": 120,
+ "rate-time": 60,
+ "rate-key": "ip:{ip},method:{method},url:{url},userId:{userId}",
+ "scope": [
+ "rows.write",
+ "documents.write"
+ ],
+ "platforms": [
+ "console",
+ "server"
+ ],
+ "packaging": false,
+ "auth": {
+ "Project": []
+ }
+ },
+ "security": [
+ {
+ "Project": [],
+ "Key": []
+ }
+ ],
+ "parameters": [
+ {
+ "name": "databaseId",
+ "description": "Database ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": ""
+ },
+ "in": "path"
+ },
+ {
+ "name": "tableId",
+ "description": "Table ID.",
+ "required": true,
+ "schema": {
+ "type": "string",
+ "x-example": "