delete-role

Remove a role from your workspace. This also removes the role from all assigned API keys. Important: This operation cannot be undone and immediately affects all API keys that had this role assigned. All keys with this role will lose the associated permissions, and access to resources protected by this role’s permissions will be denied. Required permissions:

rbac.*.delete_role

See the API reference for the full HTTP endpoint documentation.

Usage

unkey api permissions delete-role [flags]

Flags

string

required

The role ID or name to permanently delete. Must be 1-128 characters and either a valid role ID that begins with role_ or a role name that exists within your workspace.

Global Flags

Flag	Type	Description
`--root-key`	string	Override root key (`$UNKEY_ROOT_KEY`)
`--api-url`	string	Override API base URL (default: `https://api.unkey.com`)
`--config`	string	Path to config file (default: `~/.unkey/config.toml`)
`--output`	string	Output format. Use `json` for raw JSON

Examples

unkey api permissions delete-role --role=role_dns_manager

unkey api permissions delete-role --role=admin

unkey api permissions delete-role --role=role_dns_manager --output=json

Output

Default output shows the request ID with latency:

req_2c9a0jf23l4k567 (took 38ms)

{}

With --output=json, the full response envelope is returned:

{
  "meta": {
    "requestId": "req_2c9a0jf23l4k567"
  },
  "data": {}
}

Getting Started

Platform

Build & Deploy

Networking

Observability

CLI

Security

Keyspaces

AI Code Gen

Audit Logs

CLI

Errors

Usage

Flags

Global Flags

Examples

Output

​Usage

​Flags

​Global Flags

​Examples

​Output

Usage

Flags

Global Flags

Examples

Output