v25

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015053126.2 KB
Roles

Update a Redis Software role

Update a role configuration by unique ID.

put/v1/roles/{uid}

Path parameters

uidinteger required

The role unique ID.

Query parameters

dry_runboolean

Validate the request without persisting changes.

Request body

account_idinteger

Account ID. Only applicable to account-scoped roles.

management'none' | 'db_viewer' | 'cluster_viewer' | 'db_member' | 'cluster_member' | 'user_manager' | 'admin'

Name of the management role.

namestring

Role's name.

Example request

{
  "management": "cluster_member"
}

Response

Role updated successfully.

account_idinteger

Account ID. Only applicable to account-scoped roles.

management'none' | 'db_viewer' | 'cluster_viewer' | 'db_member' | 'cluster_member' | 'user_manager' | 'admin' required

Name of the management role.

namestring required

Role's name.

uidinteger required

Role's unique uid.

Example response

{
  "management": "cluster_member",
  "name": "DBA",
  "uid": 1
}