# Update role

Update an existing role.

Provide the role ID as a path parameter to specify which role to update, and send the updated role information in the request body.

This route does not update permissions for the role. Use the attach permissions to role route to manage role permissions.

You can obtain the role ID using the Get roles API.

Endpoint: PATCH /resources/roles/v1/{roleId}
Security: bearer

## Path parameters:

  - `roleId` (string, required)

## Header parameters:

  - `frontegg-tenant-id` (string)
    For relating a role to a specific account (tenant), use get accounts (tenants) API to find the account (tenant) Ids

## Request fields (application/json):

  - `isDefault` (boolean)
    This role will be assigned for every user that will be added without specified roles

  - `firstUserRole` (boolean)
    This role will be assigned to the first user of a tenant (new tenants only)

  - `migrateRole` (boolean)
    Set this property to true together with isDefault in order to assign this role to all users

  - `level` (number)
    Role level for roles elevation, lower level means stronger role.

  - `key` (string)

  - `name` (string)

  - `description` (string)

## Response 200 fields (application/json):

  - `id` (string, required)

  - `vendorId` (string, required)

  - `tenantId` (string, required)

  - `key` (string, required)

  - `name` (string, required)

  - `description` (string, required)

  - `isDefault` (boolean, required)

  - `firstUserRole` (boolean, required)

  - `level` (number, required)

  - `createdAt` (string, required)

  - `updatedAt` (string, required)

  - `permissions` (array, required)