Roles & Permissions¶

Detailed guide on managing roles and permissions in USSO.

Creating Roles¶

curl -X POST http://localhost:8000/api/sso/v1/roles \
  -H "Authorization: Bearer TOKEN" \
  -d '{
    "name": "Content Editor",
    "slug": "content-editor",
    "scopes": ["read:posts", "write:posts", "read:users"]
  }'

Assigning Roles¶

curl -X PATCH http://localhost:8000/api/sso/v1/users/USER_ID \
  -d '{"roles": ["content-editor"]}'

Role Hierarchies¶

Create logical role structures:

admin → Full access
manager → Team management
editor → Content management
viewer → Read-only

Learn more →