> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns. > > **Recommended**: > ```bash > npx @scalekit-inc/cli setup > ``` > > Global: > ```bash > npm install -g @scalekit-inc/cli > scalekit setup > ``` > > Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for 40+ agents. > Features: full-stack-auth, agent-auth, mcp-auth, modular-sso, modular-scim. > [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/) --- # Roles Define and assign organization roles
Use the role client to define organization roles and list role assignments. Create roles and permissions for authorization after you have organizations and users. ### CreateRole
CreateRole creates a new role in the environment Request context Role creation payload. The created resource.
### GetRole
GetRole retrieves a role by name Request context Role name. The response payload for this operation.
### ListRoles
ListRoles lists all roles in the environment Request context Paginated results.
### UpdateRole
UpdateRole updates an existing role by name Request context Role name. Role update payload. The updated resource.
### DeleteRole
DeleteRole deletes a role by name Request context Role name. Reassign role name. error
### GetRoleUsersCount
GetRoleUsersCount gets the count of users associated with a role Request context Role name. The response payload for this operation.
### CreateOrganizationRole
CreateOrganizationRole creates a new role in an organization Request context Org id. Role creation payload. The created resource.
### GetOrganizationRole
GetOrganizationRole retrieves an organization role by name Request context Role name. The response payload for this operation.
### ListOrganizationRoles
ListOrganizationRoles lists all roles in an organization Request context Org id. Paginated results.
### UpdateOrganizationRole
UpdateOrganizationRole updates an existing organization role by name Request context Role name. Role update payload. The updated resource.
### DeleteOrganizationRole
DeleteOrganizationRole deletes an organization role by name Request context Role name. Reassign role name. error
### GetOrganizationRoleUsersCount
GetOrganizationRoleUsersCount gets the count of users associated with an organization role Request context Role name. The response payload for this operation.
### UpdateDefaultOrganizationRoles
UpdateDefaultOrganizationRoles updates the default roles for an organization Request context Default member role. The updated resource.
### DeleteOrganizationRoleBase
DeleteOrganizationRoleBase deletes the base relationship for an organization role Request context Role name. error
### DeleteRoleBase
DeleteRoleBase deletes the base relationship for an environment-level role Request context Role name. error
### UpdateDefaultRoles
UpdateDefaultRoles updates the environment-level default creator and member roles Request context Default member role. The updated resource.
### ListDependentRoles
ListDependentRoles lists all roles that depend on the specified role Request context Role name. Paginated results.
--- ## More Scalekit documentation | Resource | What it contains | When to use it | |----------|-----------------|----------------| | [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content | | [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas | | [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |