Skip to content

docs(permissions): clarify group permission vs Group Manager scope#406

Merged
Subash-Mohan merged 2 commits into
mainfrom
docs/permissions-scope-clarity
Jun 29, 2026
Merged

docs(permissions): clarify group permission vs Group Manager scope#406
Subash-Mohan merged 2 commits into
mainfrom
docs/permissions-scope-clarity

Conversation

@Subash-Mohan

@Subash-Mohan Subash-Mohan commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Description

  • Add a "Group permission vs. Group Manager" section contrasting reach: enabling a Manage X permission on a group gives every member full org-wide management of that resource type, while a Group Manager is scoped to that group's private resources and can't make anything public.
  • Correct "Manage Actions" from "organization-wide only" to scopeable for Group Managers — scoped through the managed group's agents (tools/MCP have no direct group association).
  • Add managing actions to "What a Group Manager can do" and make the "cannot make a resource public" limit explicit.

How Has This Been Tested?

  • Verified the documented behavior against the new-permission-system branch code and the Group-Based Permissions System V2 solution design.

- Add a "Group permission vs. Group Manager" section contrasting blast
  radius: enabling a Manage X permission on a group grants every member
  full org-wide management of that resource type, whereas a Group Manager
  is scoped to that group's private resources and can't make anything public.
- Correct "Manage Actions" from "organization-wide only" to scopeable for
  Group Managers, scoped through the managed group's agents (tools/MCP have
  no direct group association).
- Add managing actions to "What a Group Manager can do" and make the
  "cannot make a resource public" limit explicit.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@mintlify

mintlify Bot commented Jun 29, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
onyx 🟢 Ready View Preview Jun 29, 2026, 6:29 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@Subash-Mohan Subash-Mohan merged commit e98953d into main Jun 29, 2026
4 checks passed
@Subash-Mohan Subash-Mohan deleted the docs/permissions-scope-clarity branch June 29, 2026 16:19
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