Create a new role

post

https://{buzz_key}.api.beeswax.com/rest/v2/roles

Create a new role along with its permissions and report permissions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

account_id

integer | null

The account associated with the role. Defaults to the current account.

alternative_id

string | null

An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.

dashboard_ids

array

List of dashboard IDs users associated with this role should be able to access

dashboard_ids

name

string

required

notes

string | null

Free-form notes of up to 255 characters.

parent_role_id

integer

required

permissions

array of objects

Object containing resource-level permissions for this Role

permissions

report_field_group_ids

array

List of report field group IDs users associated with this role should be able to access

report_field_group_ids

report_ids

array of integers

List of IDs of reports users associated with this role should be able to access. A list of reports may be queried using /reporting/reports.

report_ids

shared_across_accounts

boolean

Defaults to false

Responses

400

Invalid data.

401

Unauthorized.

403

Permission denied. You do not have rights to manage roles.

500

Internal server error.

201Role created successfully.