[SILO-952] feat: add OAuth scopes support docs

docs/.vitepress/config.mts

@@ -141,7 +141,7 @@ export default withMermaid(defineConfig({
     nav: [
       { text: 'Self-hosting', link: '/self-hosting/overview' },
       { text: 'API Reference', link: '/api-reference/introduction' },
-      { text: 'Build and extend', link: '/dev-tools/build-plane-app' },
+      { text: 'Build and extend', link: '/dev-tools/build-plane-app/overview' },
       { text: 'Plane Docs', link: 'https://docs.plane.so' },
       { text: 'Sign in', link: 'https://app.plane.so/sign-in' }
     ],
@@ -649,7 +649,17 @@ export default withMermaid(defineConfig({
         {
           text: 'Build and extend Plane',
           items: [
-            { text: 'Build Plane App', link: '/dev-tools/build-plane-app' },
+            {
+              text: 'Build Plane App', collapsed: false, items: [
+                { text: 'Overview', link: '/dev-tools/build-plane-app/overview' },
+                { text: 'Create an OAuth application', link: '/dev-tools/build-plane-app/create-oauth-application' },
+                { text: 'Choose token Flow', link: '/dev-tools/build-plane-app/choose-token-flow' },
+                { text: 'Handling webhooks', link: '/dev-tools/build-plane-app/webhooks' },
+                { text: 'OAuth scopes', link: '/dev-tools/build-plane-app/oauth-scopes' },
+                { text: 'SDKs', link: '/dev-tools/build-plane-app/sdks' },
+                { text: 'Complete examples', link: '/dev-tools/build-plane-app/examples' }
+              ]
+            },
             {
               text: 'Agents',
               collapsed: false,

docs/api-reference/customer/add-customer-property.md

@@ -131,6 +131,14 @@ External ID from the external source.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.properties:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -141,6 +149,7 @@ External ID from the external source.
 curl -X POST \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/" \
   -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
   "name": "example-name",
@@ -241,3 +250,4 @@ const data = await response.json();
 
 </div>
 </div>
+

docs/api-reference/customer/add-customer-request.md

@@ -59,6 +59,14 @@ Description of the request.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.requests:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -69,6 +77,7 @@ Description of the request.
 curl -X POST \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/requests/" \
   -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
   "title": "example-title",

docs/api-reference/customer/add-customer.md

@@ -53,6 +53,14 @@ Email address of the customer.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -63,6 +71,7 @@ Email address of the customer.
 curl -X POST \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/" \
   -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
   "name": "example-name",

docs/api-reference/customer/delete-customer-property.md

@@ -38,6 +38,14 @@ The unique identifier for the customer property.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.properties:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -47,7 +55,8 @@ The unique identifier for the customer property.
 ```bash
 curl -X DELETE \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/{property_id}/" \
-  -H "X-API-Key: $PLANE_API_KEY"
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/delete-customer-request.md

@@ -44,6 +44,14 @@ The unique identifier for the request.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.requests:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -54,6 +62,7 @@ The unique identifier for the request.
 curl -X DELETE \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/requests/{request_id}/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/delete-customer.md

@@ -38,6 +38,14 @@ The unique identifier for the customer.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -47,7 +55,8 @@ The unique identifier for the customer.
 ```bash
 curl -X DELETE \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/" \
-  -H "X-API-Key: $PLANE_API_KEY"
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/get-customer-detail.md

@@ -38,6 +38,14 @@ The unique identifier for the customer.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -48,6 +56,7 @@ The unique identifier for the customer.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/get-customer-property-detail.md

@@ -38,6 +38,14 @@ The unique identifier for the customer property.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.properties:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -48,6 +56,7 @@ The unique identifier for the customer property.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/{property_id}/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/get-customer-property-value.md

@@ -44,6 +44,14 @@ The unique identifier for the customer property.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.property_values:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -54,6 +62,7 @@ The unique identifier for the customer property.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/property-values/{property_id}/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/get-customer-request-detail.md

@@ -44,6 +44,14 @@ The unique identifier for the request.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.requests:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -54,6 +62,7 @@ The unique identifier for the request.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/requests/{request_id}/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/link-work-items-to-customer.md

@@ -53,6 +53,14 @@ Array of work item IDs to link to the customer.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.work_items:write`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -63,6 +71,7 @@ Array of work item IDs to link to the customer.
 curl -X POST \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/work-items/" \
   -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
   "issue_ids": "example-issue_ids"

docs/api-reference/customer/list-customer-properties.md

@@ -59,6 +59,14 @@ Number of results to skip for pagination.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.properties:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -68,7 +76,8 @@ Number of results to skip for pagination.
 ```bash
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customer-properties/" \
-  -H "X-API-Key: $PLANE_API_KEY"
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/list-customer-property-values.md

@@ -77,6 +77,14 @@ Number of results to skip for pagination.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.property_values:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -86,7 +94,8 @@ Number of results to skip for pagination.
 ```bash
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/property-values/" \
-  -H "X-API-Key: $PLANE_API_KEY"
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/list-customer-requests.md

@@ -71,6 +71,14 @@ Number of results to skip for pagination.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.requests:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -80,7 +88,8 @@ Number of results to skip for pagination.
 ```bash
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/requests/" \
-  -H "X-API-Key: $PLANE_API_KEY"
+  -H "X-API-Key: $PLANE_API_KEY" \
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>

docs/api-reference/customer/list-customer-work-items.md

@@ -38,6 +38,14 @@ The unique identifier for the customer.
 </div>
 </div>
 
+<div class="params-section">
+
+### Scopes
+
+`customers.work_items:read`
+
+</div>
+
 </div>
 <div class="api-right">
 
@@ -48,6 +56,7 @@ The unique identifier for the customer.
 curl -X GET \
   "https://api.plane.so/api/v1/workspaces/my-workspace/customers/{customer_id}/work-items/" \
   -H "X-API-Key: $PLANE_API_KEY"
+  # Or use -H "Authorization: Bearer $PLANE_OAUTH_TOKEN" \
 ```
 
 </template>