---
title: "Add permissions to role"
method: POST
path: "/api/v1/roles/{role_name}/permissions"
tags: ["Roles"]
---

# Add permissions to role

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

Adds one or more permissions to the specified role while preserving existing permission assignments. Use this endpoint to grant additional capabilities to a role without affecting its current permission set. Provide the role name as a path parameter and a list of permission names in the request body. The system will validate that all specified permissions exist in the environment and add them to the role. Existing permission assignments remain unchanged, making this operation safe for incremental permission management. This is useful for gradually expanding role capabilities or adding new permissions as your system evolves. Returns the updated list of all permissions now assigned to the role.

## Path parameters

- `role_name` string, required

## Request body

- RolesServiceAddPermissionsToRoleBody
  - `permission_names` string[] — List of permission names to add to the role

## Response `200`

Permissions added to role successfully. Returns the complete list of all permissions now assigned to the role, including both existing and newly added permissions.

- RolesAddPermissionsToRoleResponse
  - `permissions` RolesPermission[] — List of all permissions belonging to the role after addition
    - `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)