Add Roles - Unkey Docs

POST

keys.addRoles

Adds roles to a key. Existing roles are not removed.

To use this endpoint, your root key must have the rbac.*.add_role_to_key and potentially the rbac.*.create_role permissions.

Changelog

Date	Changes
Jul 08 2024	Introduced endpoint

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

application/json

keyId

string

required

The id of the key.

Minimum length: 1

roles

object[]

required

The roles you want to set for this key. This overwrites all existing roles. Setting roles requires the rbac.*.add_role_to_key permission.

200 - application/json

string

required

The id of the role. This is used internally

name

string

required

The name of the role

Was this page helpful?