Delete role

DELETE

/api/v1/roles/{name}

Delete a custom role. Built-in roles cannot be deleted. Roles with assigned users cannot be deleted (409).

Authorizations

• bearerAuth

Parameters

Path Parameters

name

required

string

Uppercase role name

Responses

204

Role deleted

401

Unauthorized

object

error

object

code

string

message

string

status

required

integer format: int32

403

Forbidden — cannot delete built-in role

object

error

object

code

string

message

string

status

required

integer format: int32

404

Role not found

object

error

object

code

string

message

string

status

required

integer format: int32

409

Role has assigned users; reassign them first

object

error

object

code

string

message

string

status

required

integer format: int32