---
search:
  tags:
    - administration
    - PATCH
seo:
  description: >-
    What this does: Updates only the specified fields of a custom… Reference for
    the PATCH /administration/roles/{id} endpoint in the Leadtime Public API
    API.
sidebar:
  badge: PATCH
  label: Partially update role
title: Partially update role
type: openapi-operation
---
**What this does:**
Updates only the specified fields of a custom role. Fields that are not provided remain unchanged. This is useful for making small adjustments without resending the entire role configuration.

**Important restrictions:**
- Base roles (Root, CEO, Team Leader, Staff, Guest) cannot be updated
- Only custom roles can be modified
- Permissions cannot be updated via this endpoint (use PUT /roles/:id/permissions or PATCH /roles/:id/permissions/:permissionKey)

**What can be updated:**
- name: Change the role display name
- description: Update the role description
- icon: Change the role icon
- parentId: Change the parent role (permissions will be inherited from new parent)
- type: Change role type between normal and guest

**What happens:**
- Only provided fields are updated
- Unspecified fields keep their current values
- If parentId is changed, permissions are recalculated based on the new parent
- Role metadata (editedAt) is automatically updated

**Use cases:**
- Rename a role without changing permissions
- Update role description or icon
- Change role type (e.g., convert normal role to guest role)
- Reassign parent role for permission inheritance

**Note:** To update permissions, use PUT /roles/:id/permissions or PATCH /roles/:id/permissions/:permissionKey.

<Operation source="api-reference" id="rolescontroller-patchrole" />