Skip to content

[DAL-834] Document OAuth scope management - #39469

Merged
imaique merged 5 commits into
masterfrom
michael.osuji/remove-mcp-scope-management-line
Aug 26, 2026
Merged

[DAL-834] Document OAuth scope management#39469
imaique merged 5 commits into
masterfrom
michael.osuji/remove-mcp-scope-management-line

Conversation

@imaique

@imaique imaique commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Motivation

Application Scope Management is no longer limited to MCP applications.

Changes

  • Remove the stale MCP-only availability statement from the Application Scope Management documentation.
  • Explain how scope changes affect users and existing authorizations.
  • Document future scope handling and required Datadog Mobile App scopes.
  • Add the complete configuration and save steps.
  • Define new scopes as scopes that the application starts requesting after the administrator saves the configuration.

Follow-up

The PR also replaces the outdated screenshot with the current Application Scope Management interface.

This PR incorporates the scope management guidance from #38920 and supersedes that PR.

This PR was AI-assisted using @codex.

@chatgpt-codex-connector

Copy link
Copy Markdown

To use Codex here, create an environment for this repo.

@github-actions

Copy link
Copy Markdown
Contributor

Preview links (active after the build_preview check completes)

Modified Files

@imaique imaique changed the title Remove MCP-only scope management note [DAL-834] Document OAuth scope management Aug 25, 2026
@imaique
imaique marked this pull request as ready for review August 26, 2026 15:40
@imaique
imaique requested a review from a team as a code owner August 26, 2026 15:40
@drichards-87 drichards-87 self-assigned this Aug 26, 2026

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0c69d408d9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Enable Application Scope Management to modify the allowed scopes for an application.

Only MCP applications support Application Scope Management.
Adding or removing a scope affects access to the application for all users in your organization. Disabling a scope revokes existing authorizations that include the scope. Affected users must re-authorize the application to regain access with the remaining allowed scopes.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Document re-authorization when enabling a scope

When an application already has authorized users, enabling another scope does not add it to their existing authorizations; the replacement screenshot explicitly states that users must manually re-authorize to grant the new scope. This paragraph explains re-authorization only after disabling a scope, so administrators may expect saving an added scope to update existing grants and then encounter authorization failures. Document the corresponding re-authorization requirement for enabled scopes.

Useful? React with 👍 / 👎.

@drichards-87 drichards-87 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left some feedback from Docs on the PR.

Comment thread hugo/content/en/account_management/org_settings/mobile_third_party_access.md Outdated
Comment thread hugo/content/en/account_management/org_settings/mobile_third_party_access.md Outdated
@imaique
imaique requested a review from drichards-87 August 26, 2026 16:06
@github-actions github-actions Bot added the Images Images are added/removed with this PR label Aug 26, 2026
@imaique
imaique merged commit ae5b207 into master Aug 26, 2026
33 of 34 checks passed
@imaique
imaique deleted the michael.osuji/remove-mcp-scope-management-line branch August 26, 2026 17:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Images Images are added/removed with this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants