diff --git a/docs/dev-tools/build-plane-app/choose-token-flow.md b/docs/dev-tools/build-plane-app/choose-token-flow.md
index 88b8119..ecd5b02 100644
--- a/docs/dev-tools/build-plane-app/choose-token-flow.md
+++ b/docs/dev-tools/build-plane-app/choose-token-flow.md
@@ -48,6 +48,7 @@ GET https://api.plane.so/auth/o/authorize-app/
   ?client_id=YOUR_CLIENT_ID
   &response_type=code
   &redirect_uri=https://your-app.com/callback
+  &scope=scopeA scopeB scopeC
 ```
 
 ### 2. Handle the callback
diff --git a/docs/dev-tools/build-plane-app/oauth-scopes.md b/docs/dev-tools/build-plane-app/oauth-scopes.md
index f42ddcd..fd4ec16 100644
--- a/docs/dev-tools/build-plane-app/oauth-scopes.md
+++ b/docs/dev-tools/build-plane-app/oauth-scopes.md
@@ -124,6 +124,13 @@ This document lists all OAuth scopes available when building a Plane app. Reques
 | -------------- | ----------------- |
 | `profile:read` | Read user profile |
 
+## Assets scopes
+
+| Scope          | Description              |
+| -------------- | ------------------------ |
+| `assets:read`  | Read assets              |
+| `assets:write` | Create and update assets |
+
 ## Agent Run scopes
 
 | Scope                         | Description                            |