---
title: "Updates a specific user role."
method: PUT
path: "/accessmanagement/userroles/{userRoleId}"
tags: ["accessmanagement - user roles"]
---

# Updates a specific user role.

`PUT /accessmanagement/userroles/{userRoleId}`

## Request

- Base URL: `https://manager.digicertdns.com/v1`
- URL: `https://manager.digicertdns.com/v1/accessmanagement/userroles/{userRoleId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/digicert/apis/digicert-dns/docs/accessmanagement/userroles/:userRoleId/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint updates a specific user role, making it easier to maintain clear and accurate role definitions.</br></br>Key features include:</br></br>- **Clear success messaging:** Returns a `200` success code with a confirmation message indicating the successful completion of the requested action.</br>- **Comprehensive error handling:** Returns `400` and `404` error codes with clear descriptions when requests fail.</br>- **Reliable user role updates:** Facilitates the modification of a specific user role, ensuring accurate and up-to-date information across the system.</br>- **Targeted data updates:** Leverages the `userRoleId` parameter in the URL path to update the specified user role, ensuring accurate and focused modifications.

## Path parameters

- `userRoleId` integer, required

## Request body

- UpdateUserRoleRequest
  - `name` string
  - `description` string

## Response `200`

User role updated successfully.

- UserRole
  - `id` integer
  - `name` string
  - `roleType` string
  - `description` string
  - `isSystemRole` boolean
  - `canDelete` boolean
  - `canRename` boolean
  - `resourceGroupCount` number
  - `userCount` number
  - `created_ts` string
  - `modified_ts` string

## Other responses

- `400`: Request is malformed or invalid.
- `404`: Resource not found.

---

[API](https://skmtc.dev/digicert/apis/digicert-dns.md) - [All operations](https://skmtc.dev/digicert/apis/digicert-dns/llms.txt) - [OpenAPI document](https://skmtc.dev/digicert/apis/digicert-dns/revisions/c74fc728cff8?raw)