> **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 `scalekitClient.permissions()` 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">
  
    
      

      Runs `createPermission` and returns the result.

      
        Request payload.
      
      
        Permission management CreatePermissionResponse
      

```java wrap showLineNumbers=false

CreatePermissionRequest req = CreatePermissionRequest.newBuilder().build();
scalekitClient.permissions().createPermission(req);
```

    
  
</div>

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

      Runs `getPermission` and returns the result.

      
        Permission name.
      
      
        The response payload for this operation.
      

```java wrap showLineNumbers=false
scalekitClient.permissions().getPermission("read:documents");
```

    
  
</div>

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

      Runs `listPermissions` and returns the result.

      
        Page token.
      
      
        Deprecated ListPermissionsResponse
      

```java wrap showLineNumbers=false
scalekitClient.permissions().listPermissions("next_page_token");
```

    
  
</div>

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

      Runs `updatePermission` and returns the result.

      
        Permission name.
      
      
        Request payload.
      
      
        The updated resource.
      

```java wrap showLineNumbers=false

UpdatePermissionRequest req = UpdatePermissionRequest.newBuilder().build();
scalekitClient.permissions().updatePermission("read:documents", req);
```

    
  
</div>

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

      Runs `deletePermission` and returns the result.

      
        Permission name.
      
      
        No return value
      

```java wrap showLineNumbers=false
scalekitClient.permissions().deletePermission("read:documents");
```

    
  
</div>

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

      Runs `listRolePermissions` and returns the result.

      
        Role name.
      
      
        Permission relationships ListRolePermissionsResponse
      

```java wrap showLineNumbers=false
scalekitClient.permissions().listRolePermissions("admin");
```

    
  
</div>

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

      Runs `addPermissionsToRole` and returns the result.

      
        Role name.
      
      
        Request payload.
      
      
        The created resource.
      

```java wrap showLineNumbers=false

AddPermissionsToRoleRequest req = AddPermissionsToRoleRequest.newBuilder().build();
scalekitClient.permissions().addPermissionsToRole("admin", req);
```

    
  
</div>

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

      Runs `removePermissionFromRole` and returns the result.

      
        Role name.
      
      
        Permission name.
      
      
        No return value
      

```java wrap showLineNumbers=false
scalekitClient.permissions().removePermissionFromRole("admin", "read:documents");
```

    
  
</div>

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

      Runs `listEffectiveRolePermissions` and returns the result.

      
        Role name.
      
      
        Paginated results.
      

```java wrap showLineNumbers=false
scalekitClient.permissions().listEffectiveRolePermissions("admin");
```

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