---
title: "Update permission details"
method: PUT
path: "/api/v1/permissions/{permission_name}"
tags: ["Permissions"]
---

# Update permission details

`PUT /api/v1/permissions/{permission_name}`

Modifies an existing permission's attributes including description and metadata. Use this endpoint to update permission descriptions or clarify permission purposes after creation. The permission is identified by its unique name in the path parameter, and only the fields you specify in the request body will be updated. Note that the permission name itself cannot be changed as it serves as the immutable identifier. This operation is useful for maintaining clear documentation of permission purposes or updating descriptions to reflect changes in system functionality. Returns the updated permission object with modified timestamps.

## Path parameters

- `permission_name` string, required

## Request body

- V1rolesCreatePermission
  - `description` string — Description of the permission
  - `name` string — Unique name/ID of the permission. Must be 1–64 characters using only letters, numbers, underscores (_), and colons (:).

## Response `200`

Permission updated successfully. Returns the modified permission object with updated description and timestamps.

- RolesUpdatePermissionResponse
  - `permission` RolesPermission
    - `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)