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'