---
title: "List permissions for role"
method: GET
path: "/api/v1/roles/{role_name}/permissions"
tags: ["Roles"]
---

# List permissions for role

`GET /api/v1/roles/{role_name}/permissions`

Retrieves all permissions directly assigned to the specified role, excluding permissions inherited from base roles. Use this endpoint to view the explicit permission assignments for a role, which is useful for understanding direct role capabilities, auditing permission assignments, or managing role-permission relationships. Provide the role name as a path parameter, and the response will include only the permissions that are directly assigned to that role. This operation does not include inherited permissions from role hierarchies - use ListEffectiveRolePermissions to see the complete set of permissions including inheritance. Returns a list of permission objects with their names, descriptions, and assignment metadata.

## Path parameters

- `role_name` string, required

## Response `200`

Successfully retrieved role permissions. Returns a list of all permissions directly assigned to the specified role, excluding inherited permissions.

- RolesListRolePermissionsResponse
  - `permissions` RolesPermission[] — List of permissions directly assigned to the role
    - `create_time` string, date-time
    - `description` string
    - `id` string
    - `is_scalekit_permission` boolean — Indicates whether this permission is predefined by Scalekit
    - `name` string
    - `update_time` string, date-time

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)