Environment Roles
- Defined at the platform level
- Inherited by all organizations
- Immutable at the organization level
- Managed by platform administrators only
- Marked with
inherited: trueandtype: ENVIRONMENT_ROLE
Organization Roles
- Defined at the organization level
- Scoped to a single organization
- Fully mutable by organization admins
- Marked with
inherited: falseandtype: ORGANIZATION_ROLE - Reference the
organizationIdthey belong to
When to Use Each
| Use Case | Role Type |
|---|---|
| Platform-wide admin access | Environment |
| Default member role for all orgs | Environment |
| Custom team-specific access | Organization |
| Department-level access | Organization |