---
title: "Update the permission"
method: PATCH
path: "/permissions/{permissionId}"
tags: ["Permissions"]
---

# Update the permission

`PATCH /permissions/{permissionId}`

## Request

- Base URL: `https://api-staging.fanheroapi.com`
- URL: `https://api-staging.fanheroapi.com/permissions/{permissionId}`
- Auth: API key in header `apiKey`

## Headers

- `organization` string, required

## Request body

- UpdatePermissionInput
  - `name` string: Permission name
  - `description` string: Permission description
  - `actions` string[]: The actions that this permission allows to be performed on the subject

## Response `200`

Permission updated

- PermissionDto
  - `id` string, required: Permission ID
  - `name` string, required: Permission name
  - `description` string, required: Permission description
  - `subject` SubjectDto, required
    - `id` string: Subject ID
    - `fields` string[]: Fields
    - `entity` string: Entity identified by this subject
  - `actions` string[], required: The actions that this permission allows to be performed on the subject

---

[API](https://skmtc.dev/fanhero/apis/user-management-endpoints.md) - [All operations](https://skmtc.dev/fanhero/apis/user-management-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/fanhero/apis/user-management-endpoints/revisions/3f982670c057?raw)