diff --git a/app/controllers/api/account.php b/app/controllers/api/account.php
index 80c2b69ba3..bd9562110f 100644
--- a/app/controllers/api/account.php
+++ b/app/controllers/api/account.php
@@ -4599,7 +4599,7 @@ App::post('/v1/account/targets/push')
     ->label('sdk', new Method(
         namespace: 'account',
         name: 'createPushTarget',
-        description: '',
+        description: '/docs/references/account/create-push-target.md',
         auth: [AuthType::SESSION],
         responses: [
             new SDKResponse(
@@ -4679,7 +4679,7 @@ App::put('/v1/account/targets/:targetId/push')
     ->label('sdk', new Method(
         namespace: 'account',
         name: 'updatePushTarget',
-        description: '',
+        description: '/docs/references/account/update-push-target.md',
         auth: [AuthType::SESSION],
         responses: [
             new SDKResponse(
@@ -4743,7 +4743,7 @@ App::delete('/v1/account/targets/:targetId/push')
     ->label('sdk', new Method(
         namespace: 'account',
         name: 'deletePushTarget',
-        description: '',
+        description: '/docs/references/account/delete-push-target.md',
         auth: [AuthType::SESSION],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/databases.php b/app/controllers/api/databases.php
index 4107614fa0..65a428c011 100644
--- a/app/controllers/api/databases.php
+++ b/app/controllers/api/databases.php
@@ -4150,7 +4150,7 @@ App::get('/v1/databases/usage')
     ->label('sdk', new Method(
         namespace: 'databases',
         name: 'getUsage',
-        description: '',
+        description: '/docs/references/databases/get-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -4239,7 +4239,7 @@ App::get('/v1/databases/:databaseId/usage')
     ->label('sdk', new Method(
         namespace: 'databases',
         name: 'getDatabaseUsage',
-        description: '',
+        description: '/docs/references/databases/get-database-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -4334,7 +4334,7 @@ App::get('/v1/databases/:databaseId/collections/:collectionId/usage')
     ->label('sdk', new Method(
         namespace: 'databases',
         name: 'getCollectionUsage',
-        description: '',
+        description: '/docs/references/databases/get-collection-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/functions.php b/app/controllers/api/functions.php
index 205f96072e..89d2444366 100644
--- a/app/controllers/api/functions.php
+++ b/app/controllers/api/functions.php
@@ -624,7 +624,7 @@ App::get('/v1/functions/:functionId/usage')
     ->label('sdk', new Method(
         namespace: 'functions',
         name: 'getFunctionUsage',
-        description: '',
+        description: '/docs/references/functions/get-function-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -735,7 +735,7 @@ App::get('/v1/functions/usage')
     ->label('sdk', new Method(
         namespace: 'functions',
         name: 'getUsage',
-        description: '',
+        description: '/docs/references/functions/get-functions-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -1704,7 +1704,7 @@ App::post('/v1/functions/:functionId/deployments/:deploymentId/build')
     ->label('sdk', new Method(
         namespace: 'functions',
         name: 'createBuild',
-        description: '',
+        description: '/docs/references/functions/create-build.md',
         auth: [AuthType::KEY],
         responses: [
             new SDKResponse(
@@ -1779,7 +1779,7 @@ App::patch('/v1/functions/:functionId/deployments/:deploymentId/build')
     ->label('sdk', new Method(
         namespace: 'functions',
         name: 'updateDeploymentBuild',
-        description: '',
+        description: '/docs/references/functions/update-deployment-build.md',
         auth: [AuthType::KEY],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/project.php b/app/controllers/api/project.php
index 2fc6578c2b..cde2b150f7 100644
--- a/app/controllers/api/project.php
+++ b/app/controllers/api/project.php
@@ -27,7 +27,7 @@ App::get('/v1/project/usage')
     ->label('sdk', new Method(
         namespace: 'project',
         name: 'getUsage',
-        description: '',
+        description: '/docs/references/project/get-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/proxy.php b/app/controllers/api/proxy.php
index ef39ed0ab6..2567c23be6 100644
--- a/app/controllers/api/proxy.php
+++ b/app/controllers/api/proxy.php
@@ -327,7 +327,7 @@ App::patch('/v1/proxy/rules/:ruleId/verification')
     ->label('sdk', new Method(
         namespace: 'proxy',
         name: 'updateRuleVerification',
-        description: '',
+        description: '/docs/references/proxy/update-rule-verification.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/storage.php b/app/controllers/api/storage.php
index 49f8897884..b6a07c356d 100644
--- a/app/controllers/api/storage.php
+++ b/app/controllers/api/storage.php
@@ -1774,7 +1774,7 @@ App::get('/v1/storage/usage')
     ->label('sdk', new Method(
         namespace: 'storage',
         name: 'getUsage',
-        description: '',
+        description: '/docs/references/storage/get-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -1860,7 +1860,7 @@ App::get('/v1/storage/:bucketId/usage')
     ->label('sdk', new Method(
         namespace: 'storage',
         name: 'getBucketUsage',
-        description: '',
+        description: '/docs/references/storage/get-bucket-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/users.php b/app/controllers/api/users.php
index d2c840d368..962022927f 100644
--- a/app/controllers/api/users.php
+++ b/app/controllers/api/users.php
@@ -2391,7 +2391,7 @@ App::get('/v1/users/usage')
     ->label('sdk', new Method(
         namespace: 'users',
         name: 'getUsage',
-        description: '',
+        description: '/docs/references/users/get-usage.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/app/controllers/api/vcs.php b/app/controllers/api/vcs.php
index 7c31d93df5..2c145febcc 100644
--- a/app/controllers/api/vcs.php
+++ b/app/controllers/api/vcs.php
@@ -276,7 +276,7 @@ App::get('/v1/vcs/github/authorize')
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'createGitHubInstallation',
-        description: '',
+        description: '/docs/references/vcs/create-github-installation.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -457,7 +457,7 @@ App::get('/v1/vcs/github/installations/:installationId/providerRepositories/:pro
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'getRepositoryContents',
-        description: '',
+        description: '/docs/references/vcs/get-repository-contents.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -523,7 +523,7 @@ App::post('/v1/vcs/github/installations/:installationId/providerRepositories/:pr
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'createRepositoryDetection',
-        description: '',
+        description: '/docs/references/vcs/create-repository-detection.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -600,7 +600,7 @@ App::get('/v1/vcs/github/installations/:installationId/providerRepositories')
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'listRepositories',
-        description: '',
+        description: '/docs/references/vcs/list-repositories.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -700,7 +700,7 @@ App::post('/v1/vcs/github/installations/:installationId/providerRepositories')
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'createRepository',
-        description: '',
+        description: '/docs/references/vcs/create-repository.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -812,7 +812,7 @@ App::get('/v1/vcs/github/installations/:installationId/providerRepositories/:pro
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'getRepository',
-        description: '',
+        description: '/docs/references/vcs/get-repository.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -866,7 +866,7 @@ App::get('/v1/vcs/github/installations/:installationId/providerRepositories/:pro
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'listRepositoryBranches',
-        description: '',
+        description: '/docs/references/vcs/list-repository-branches.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
@@ -1204,7 +1204,7 @@ App::patch('/v1/vcs/github/installations/:installationId/repositories/:repositor
     ->label('sdk', new Method(
         namespace: 'vcs',
         name: 'updateExternalDeployments',
-        description: '',
+        description: '/docs/references/vcs/update-external-deployments.md',
         auth: [AuthType::ADMIN],
         responses: [
             new SDKResponse(
diff --git a/docs/references/account/create-push-target.md b/docs/references/account/create-push-target.md
new file mode 100644
index 0000000000..c54f180638
--- /dev/null
+++ b/docs/references/account/create-push-target.md
@@ -0,0 +1 @@
+Use this endpoint to register a device for push notifications. Provide a target ID (custom or generated using ID.unique()), a device identifier (usually a device token), and optionally specify which provider should send notifications to this target. The target is automatically linked to the current session and includes device information like brand and model.
\ No newline at end of file
diff --git a/docs/references/account/delete-push-target.md b/docs/references/account/delete-push-target.md
new file mode 100644
index 0000000000..5909a37b27
--- /dev/null
+++ b/docs/references/account/delete-push-target.md
@@ -0,0 +1 @@
+Delete a push notification target for the currently logged in user. After deletion, the device will no longer receive push notifications. The target must exist and belong to the current user.
\ No newline at end of file
diff --git a/docs/references/account/update-push-target.md b/docs/references/account/update-push-target.md
new file mode 100644
index 0000000000..997ffaafea
--- /dev/null
+++ b/docs/references/account/update-push-target.md
@@ -0,0 +1 @@
+Update the currently logged in user's push notification target. You can modify the target's identifier (device token) and provider ID (token, email, phone etc.). The target must exist and belong to the current user. If you change the provider ID, notifications will be sent through the new messaging provider instead.
\ No newline at end of file
diff --git a/docs/references/databases/get-collection-usage.md b/docs/references/databases/get-collection-usage.md
new file mode 100644
index 0000000000..48682a075f
--- /dev/null
+++ b/docs/references/databases/get-collection-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics for a collection. Returning the total number of documents. 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.
\ No newline at end of file
diff --git a/docs/references/databases/get-database-usage.md b/docs/references/databases/get-database-usage.md
new file mode 100644
index 0000000000..2c2628a464
--- /dev/null
+++ b/docs/references/databases/get-database-usage.md
@@ -0,0 +1 @@
+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.
\ No newline at end of file
diff --git a/docs/references/databases/get-usage.md b/docs/references/databases/get-usage.md
new file mode 100644
index 0000000000..d41f8704c8
--- /dev/null
+++ b/docs/references/databases/get-usage.md
@@ -0,0 +1 @@
+Get 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.
\ No newline at end of file
diff --git a/docs/references/functions/create-build.md b/docs/references/functions/create-build.md
new file mode 100644
index 0000000000..7a8ac750e8
--- /dev/null
+++ b/docs/references/functions/create-build.md
@@ -0,0 +1 @@
+Create a new build for an existing function deployment. This endpoint allows you to rebuild a deployment with the updated function configuration, including its entrypoint and build commands if they have been modified The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.
\ No newline at end of file
diff --git a/docs/references/functions/get-function-usage.md b/docs/references/functions/get-function-usage.md
new file mode 100644
index 0000000000..4498abb05b
--- /dev/null
+++ b/docs/references/functions/get-function-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics for a for a specific function. View statistics including total deployments, builds, executions, storage usage, and compute time. The response includes both current totals and historical data for each metric. 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, defaults to 30 days.
\ No newline at end of file
diff --git a/docs/references/functions/get-functions-usage.md b/docs/references/functions/get-functions-usage.md
new file mode 100644
index 0000000000..14427d335d
--- /dev/null
+++ b/docs/references/functions/get-functions-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics for a for all functions. View statistics including total functions, deployments, builds, executions, storage usage, and compute time. The response includes both current totals and historical data for each metric. 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, defaults to 30 days.
\ No newline at end of file
diff --git a/docs/references/functions/update-deployment-build.md b/docs/references/functions/update-deployment-build.md
new file mode 100644
index 0000000000..d047990adf
--- /dev/null
+++ b/docs/references/functions/update-deployment-build.md
@@ -0,0 +1 @@
+Cancel an ongoing function deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.
\ No newline at end of file
diff --git a/docs/references/project/get-usage.md b/docs/references/project/get-usage.md
new file mode 100644
index 0000000000..d6802c5588
--- /dev/null
+++ b/docs/references/project/get-usage.md
@@ -0,0 +1 @@
+Get comprehensive usage statistics for your project. View metrics including network requests, bandwidth, storage, function executions, database usage, and user activity. Specify a time range with startDate and endDate, and optionally set the data granularity with period (1h or 1d). The response includes both total counts and detailed breakdowns by resource, along with historical data over the specified period.
\ No newline at end of file
diff --git a/docs/references/proxy/update-rule-verification.md b/docs/references/proxy/update-rule-verification.md
new file mode 100644
index 0000000000..c06994bc59
--- /dev/null
+++ b/docs/references/proxy/update-rule-verification.md
@@ -0,0 +1 @@
+Retry getting verification process of a proxy rule. This endpoint triggers domain verification by checking DNS records (CNAME) against the configured target domain. If verification is successful, a TLS certificate will be automatically provisioned for the domain.
\ No newline at end of file
diff --git a/docs/references/storage/get-bucket-usage.md b/docs/references/storage/get-bucket-usage.md
new file mode 100644
index 0000000000..98e9867831
--- /dev/null
+++ b/docs/references/storage/get-bucket-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics a specific bucket in the project. You can view the total number of files, 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.
diff --git a/docs/references/storage/get-usage.md b/docs/references/storage/get-usage.md
new file mode 100644
index 0000000000..697c680001
--- /dev/null
+++ b/docs/references/storage/get-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics for all buckets in the project. You can view the total number of buckets, files, 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.
diff --git a/docs/references/users/get-usage.md b/docs/references/users/get-usage.md
new file mode 100644
index 0000000000..2a9379c847
--- /dev/null
+++ b/docs/references/users/get-usage.md
@@ -0,0 +1 @@
+Get usage metrics and statistics for all users in the project. You can view the total number of users and sessions. 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.
diff --git a/docs/references/vcs/create-github-installation.md b/docs/references/vcs/create-github-installation.md
new file mode 100644
index 0000000000..60873faf6d
--- /dev/null
+++ b/docs/references/vcs/create-github-installation.md
@@ -0,0 +1 @@
+Begin Appwrite's GitHub's app installation to set up version control integration. This endpoint responds with a redirect URL to the GitHub App's installation page. The GitHub App must be configured in your environment for this endpoint to work.
\ No newline at end of file
diff --git a/docs/references/vcs/create-repository-detection.md b/docs/references/vcs/create-repository-detection.md
new file mode 100644
index 0000000000..d031cdc746
--- /dev/null
+++ b/docs/references/vcs/create-repository-detection.md
@@ -0,0 +1 @@
+Analyze a GitHub repository to automatically detect the programming language and runtime environment. This endpoint scans the repository's files and language statistics to determine the appropriate runtime settings for your function. The GitHub installation must be properly configured and the repository must be accessible through your installation for this endpoint to work.
\ No newline at end of file
diff --git a/docs/references/vcs/create-repository.md b/docs/references/vcs/create-repository.md
new file mode 100644
index 0000000000..771265bd01
--- /dev/null
+++ b/docs/references/vcs/create-repository.md
@@ -0,0 +1 @@
+Create a new GitHub repository through your installation. This endpoint allows you to create either a public or private repository by specifying a name and visibility setting. The repository will be created under your GitHub user account or organization, depending on your installation type. The GitHub installation must be properly configured and have the necessary permissions for repository creation.
\ No newline at end of file
diff --git a/docs/references/vcs/get-repository-contents.md b/docs/references/vcs/get-repository-contents.md
new file mode 100644
index 0000000000..ab5ef7f8da
--- /dev/null
+++ b/docs/references/vcs/get-repository-contents.md
@@ -0,0 +1 @@
+Get a list of files and directories from a GitHub repository connected to your project. This endpoint returns the contents of a specified repository path, including file names, sizes, and whether each item is a file or directory. The GitHub installation must be properly configured and the repository must be accessible through your installation for this endpoint to work.
diff --git a/docs/references/vcs/get-repository.md b/docs/references/vcs/get-repository.md
new file mode 100644
index 0000000000..ee57861114
--- /dev/null
+++ b/docs/references/vcs/get-repository.md
@@ -0,0 +1 @@
+Get detailed information about a specific GitHub repository from your installation. This endpoint returns repository details including its ID, name, visibility status, organization, and latest push date. The GitHub installation must be properly configured and have access to the requested repository for this endpoint to work.
\ No newline at end of file
diff --git a/docs/references/vcs/list-repositories.md b/docs/references/vcs/list-repositories.md
new file mode 100644
index 0000000000..f486e9b584
--- /dev/null
+++ b/docs/references/vcs/list-repositories.md
@@ -0,0 +1 @@
+Get a list of GitHub repositories available through your installation. This endpoint returns repositories with their basic information, detected runtime environments, and latest push dates. You can optionally filter repositories using a search term. Each repository's runtime is automatically detected based on its contents and language statistics. The GitHub installation must be properly configured for this endpoint to work.
\ No newline at end of file
diff --git a/docs/references/vcs/list-repository-branches.md b/docs/references/vcs/list-repository-branches.md
new file mode 100644
index 0000000000..eea1795a3e
--- /dev/null
+++ b/docs/references/vcs/list-repository-branches.md
@@ -0,0 +1 @@
+Get a list of all branches from a GitHub repository in your installation. This endpoint returns the names of all branches in the repository and their total count. The GitHub installation must be properly configured and have access to the requested repository for this endpoint to work.
diff --git a/docs/references/vcs/update-external-deployments.md b/docs/references/vcs/update-external-deployments.md
new file mode 100644
index 0000000000..22d95da9a7
--- /dev/null
+++ b/docs/references/vcs/update-external-deployments.md
@@ -0,0 +1 @@
+Authorize and create deployments for a GitHub pull request in your project. This endpoint allows external contributions by creating deployments from pull requests, enabling preview environments for code review. The pull request must be open and not previously authorized. The GitHub installation must be properly configured and have access to both the repository and pull request for this endpoint to work.
\ No newline at end of file