From e478df399abecaf41cccf3224e035adbe770b190 Mon Sep 17 00:00:00 2001
From: Mike Constantino <mconstantino@digitalocean.com>
Date: Fri, 24 Jul 2026 18:06:03 -0400
Subject: [PATCH] update spec to support project:assign_resource
 standardization

---
 .../resources/apps/models/apps_create_app_request.yml         | 2 +-
 specification/resources/databases/models/database_cluster.yml | 2 +-
 .../resources/projects/projects_assign_resources.yml          | 4 ++--
 .../resources/projects/projects_assign_resources_default.yml  | 4 ++--
 4 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/specification/resources/apps/models/apps_create_app_request.yml b/specification/resources/apps/models/apps_create_app_request.yml
index ae66f1e38..ba1caf7cf 100755
--- a/specification/resources/apps/models/apps_create_app_request.yml
+++ b/specification/resources/apps/models/apps_create_app_request.yml
@@ -5,7 +5,7 @@ properties:
     type: string
     description: |
       The ID of the project the app should be assigned to. If omitted, it will be assigned to your default project.
-      <br><br>Requires `project:update` scope.
+      <br><br>Requires `project:assign_resource` scope.
 required:
 - spec
 type: object
diff --git a/specification/resources/databases/models/database_cluster.yml b/specification/resources/databases/models/database_cluster.yml
index 260c4b3c5..1456f61e8 100644
--- a/specification/resources/databases/models/database_cluster.yml
+++ b/specification/resources/databases/models/database_cluster.yml
@@ -142,7 +142,7 @@ properties:
     type: string
     format: uuid
     example: 9cc10173-e9ea-4176-9dbc-a4cee4c4ff30
-    description: The ID of the project that the database cluster is assigned to. If excluded when creating a new database cluster, it will be assigned to your default project.<br><br>Requires `project:update` scope.
+    description: The ID of the project that the database cluster is assigned to. If excluded when creating a new database cluster, it will be assigned to your default project.<br><br>Requires `project:assign_resource` scope.
   rules:
     type: array
     items:
diff --git a/specification/resources/projects/projects_assign_resources.yml b/specification/resources/projects/projects_assign_resources.yml
index ca4e18bff..d61e69601 100644
--- a/specification/resources/projects/projects_assign_resources.yml
+++ b/specification/resources/projects/projects_assign_resources.yml
@@ -5,7 +5,7 @@ summary: Assign Resources to a Project
 description: |
   To assign resources to a project, send a POST request to `/v2/projects/$PROJECT_ID/resources`.
 
-  You must have both `project:update` and `<resource>:read` scopes to assign new resources. For example, to assign a Droplet to a project, include both the `project:update` and `droplet:read` scopes.
+  You must have both `project:assign_resource` and `<resource>:read` scopes to assign new resources. For example, to assign a Droplet to a project, include both the `project:assign_resource` and `droplet:read` scopes. The `project:update` scope also grants `project:assign_resource`.
 
 tags:
   - Project Resources
@@ -55,4 +55,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'project:update'
+    - 'project:assign_resource'
diff --git a/specification/resources/projects/projects_assign_resources_default.yml b/specification/resources/projects/projects_assign_resources_default.yml
index be561d309..78cc7eeb1 100644
--- a/specification/resources/projects/projects_assign_resources_default.yml
+++ b/specification/resources/projects/projects_assign_resources_default.yml
@@ -5,7 +5,7 @@ summary: Assign Resources to Default Project
 description: |
   To assign resources to your default project, send a POST request to `/v2/projects/default/resources`.
 
-  You must have both project:update and <resource>:read scopes to assign new resources. For example, to assign a Droplet to the default project, include both the `project:update` and `droplet:read` scopes.
+  You must have both `project:assign_resource` and `<resource>:read` scopes to assign new resources. For example, to assign a Droplet to the default project, include both the `project:assign_resource` and `droplet:read` scopes. The `project:update` scope also grants `project:assign_resource`.
 
 tags:
   - Project Resources
@@ -52,4 +52,4 @@ x-codeSamples:
 
 security:
   - bearer_auth:
-    - 'project:update'
+    - 'project:assign_resource'