Create

Create a new role.

Roles will always be created in the account / customer of the current request (if any).

Tokens

This action requires the following tokens:

  • role-write

Arguments

Required arguments are marked in bold, and optional arguments are marked in italics.

Argument Type Default Description
name String   Name of the role

Output

This action produces the following output on success:

An object containing the following fields:

Name Type Description
id Hash Role ID
name String The name of this role
customer

The customer of this role, if any

The value of this field is an object containing the following fields:

Name Type Description
id Hash Customer ID
name String The name of this customer
datecreated DateTime When this customer was created
datemodified DateTime When this customer was last modified
tokens

Tokens for this role

The value of this field is an array containing zero or more elements, each one being one Label

Errors

This action will always return one of the default status codes.