# One customer needs a role nobody else has: organization-scoped custom roles

DevFeed: [One customer needs a role nobody else has: organization-scoped custom roles](<https://devfeed.tech/articles/one-customer-needs-a-role-nobody-else-has-organization-scoped-custom-roles-115970.md>)

Original publisher: [Read original article](<https://workos.com/blog/organization-scoped-custom-roles>)

Author: WorkOS

Published: 2026-11-03T14:42:18Z

Content type: tutorial

Language: en

Sources: [WorkOS](<https://devfeed.tech/sources/workos-blog.md>)

Topics: [rbac](<https://devfeed.tech/topics/rbac.md>)

Tags: [2026](<https://devfeed.tech/tags/2026.md>), [access-control](<https://devfeed.tech/tags/access-control.md>), [admin](<https://devfeed.tech/tags/admin.md>), [api](<https://devfeed.tech/tags/api.md>), [app](<https://devfeed.tech/tags/app.md>), [application](<https://devfeed.tech/tags/application.md>), [authorization](<https://devfeed.tech/tags/authorization.md>), [b2b](<https://devfeed.tech/tags/b2b.md>), [billing](<https://devfeed.tech/tags/billing.md>), [control](<https://devfeed.tech/tags/control.md>), [custom](<https://devfeed.tech/tags/custom.md>), [customer](<https://devfeed.tech/tags/customer.md>), [customers](<https://devfeed.tech/tags/customers.md>), [dashboard](<https://devfeed.tech/tags/dashboard.md>), [environment](<https://devfeed.tech/tags/environment.md>), [needs](<https://devfeed.tech/tags/needs.md>), [one](<https://devfeed.tech/tags/one.md>), [organization](<https://devfeed.tech/tags/organization.md>), [rest](<https://devfeed.tech/tags/rest.md>), [roles](<https://devfeed.tech/tags/roles.md>)

## AI overview

Organization-scoped custom roles let one WorkOS organization have customer-specific permissions without adding role options for every tenant. Create them on an organization's Roles tab or with POST /authorization/organizations/:organizationId/roles; new roles start without permissions, which must be set separately. Use a deliberate slug if application code depends on it: slugs cannot be changed, and custom slugs are unique within the organization. Creating the first custom role also forks that organization's default role and priority order from the environment's current settings; later environment changes no longer update those settings, so review them on the organization's Roles tab. A custom role cannot be deleted while it has active assignments or identity provider group mappings. Custom and environment roles appear together in the organization's role list and work with existing assignment paths.

## Source excerpt

Environment roles apply to every organization. A custom role belongs to one, so you can give a customer the role they asked for without touching the rest.