# Update a custom role

**PUT** `/v1/roles/{roleId}`

**Operation ID**: `updateRole`
**Summary**: Update a custom role
Updates an existing custom role. System roles cannot be updated.

## Tags
- Roles
## Parameters

- **roleId** (required) - path
  - Type: string

## Request Body

**Content-Type**: `application/json`

**Schema**: `UpdateRole`

## Responses

### 200

Role updated successfully

- **Content-Type**: `application/json` / `Role`
### 400

Invalid request data or system role

### 403

Insufficient permissions

### 404

Role not found

### 409

Role name already exists