Skip to content

Fix required scope names on twelve endpoints - #1219

Merged
RohithSangati merged 1 commit into
mainfrom
fix/pdocs-4599-scope-names
Sep 10, 2026
Merged

Fix required scope names on twelve endpoints#1219
RohithSangati merged 1 commit into
mainfrom
fix/pdocs-4599-scope-names

Conversation

@beardicus

@beardicus beardicus commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Human summary

These inconsistencies were found while working on product docs updates for doctl command permission scopes (PDOCS-4599). An agent facilitated the permissions consistency search and verification.

Summary

Twelve API operations declare security scopes that do not exist in the IAM permissions catalog. Anyone following the API reference to build a custom-scoped token for these endpoints ends up with a name they cannot select. This PR replaces each one with the correct scope.

File Was Now
nfs/nfs_list.yml, nfs_snapshot_list.yml, nfs_access_point_list.yml nfs:list nfs:read
databases/databases_update_kafka_schema_config.yml, ..._subject_config.yml database:write database:update
gen-ai/genai_update_custom_model_metadata.yml genai:default genai:update
byoip_prefixes/byoip_prefixes_update.yml byoip_prefix:write byoip_prefix:update
partner_network_connect/partner_attachment_service_key_create.yml partner_network_connect:write partner_network_connect:update
dedicated_inferences/dedicated_inferences_tokens_{list,create,delete}.yml dedicated_inference_tokens:* dedicated_inference_token:*
organizations/organizations_list_teams.yml organization:read organization_membership:read_teams

How the new values were verified

Each endpoint was called against production with custom-scoped personal access tokens:

  • With a token holding only account:read, all twelve endpoints returned 403.
  • With a token holding the scopes above, all twelve endpoints were authorized.
  • The partner network connect service names the missing scope in its 403 body (you are missing the required permission partner_network_connect:update), which is how that one was pinned down.
  • GET /v2/organizations/teams returned 200 with a token holding only organization_membership:read_teams. That scope is only offered to Organization Admin, Owner, and Biller roles.

@beardicus
beardicus marked this pull request as ready for review September 9, 2026 18:44
@RohithSangati
RohithSangati merged commit 8041307 into main Sep 10, 2026
8 checks passed
@RohithSangati
RohithSangati deleted the fix/pdocs-4599-scope-names branch September 10, 2026 04:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants