# 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