> **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/)

---

# Permissions

Manage fine-grained permissions
<div class="sdk-client-page">

Use the permission client to define fine-grained permissions that roles can grant.

Model permissions for resources in your app, then attach them to roles.

### CreatePermission
<div class="sdk-method-section">
  
    
      

      CreatePermission creates a new permission

      
        Request context
      
      
        Permission creation payload.
      
      
        The created resource.
      

    
  
</div>

### GetPermission
<div class="sdk-method-section">
  
    
      

      GetPermission retrieves a permission by name

      
        Request context
      
      
        Permission name.
      
      
        The response payload for this operation.
      

    
  
</div>

### ListPermissions
<div class="sdk-method-section">
  
    
      

      ListPermissions lists all permissions with optional pagination.

      
        Request context
      
      
        Page token.
      
      
        Page size.
      
      
        Paginated results.
      

    
  
</div>

### UpdatePermission
<div class="sdk-method-section">
  
    
      

      UpdatePermission updates an existing permission by name

      
        Request context
      
      
        Permission name.
      
      
        Permission update payload.
      
      
        The updated resource.
      

    
  
</div>

### DeletePermission
<div class="sdk-method-section">
  
    
      

      DeletePermission deletes a permission by name

      
        Request context
      
      
        Permission name.
      
      
        error
      

    
  
</div>

### ListRolePermissions
<div class="sdk-method-section">
  
    
      

      ListRolePermissions lists all permissions associated with a role

      
        Request context
      
      
        Role name.
      
      
        Paginated results.
      

    
  
</div>

### AddPermissionsToRole
<div class="sdk-method-section">
  
    
      

      AddPermissionsToRole adds permissions to a role

      
        Request context
      
      
        Role name.
      
      
        Permission names.
      
      
        The created resource.
      

    
  
</div>

### RemovePermissionFromRole
<div class="sdk-method-section">
  
    
      

      RemovePermissionFromRole removes a permission from a role

      
        Request context
      
      
        Role name.
      
      
        Permission name.
      
      
        error
      

    
  
</div>

### ListEffectiveRolePermissions
<div class="sdk-method-section">
  
    
      

      ListEffectiveRolePermissions lists all effective permissions for a role (including inherited permissions)

      
        Request context
      
      
        Role name.
      
      
        Paginated results.
      

    
  
</div>

</div>


---

## 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 |