Admin > Roles

Create a role

Create a custom role in the Tines tenant.

post/api/v1/admin/roles

Request

  • Base URL: https://your-tenant.tines.com
  • URL: https://your-tenant.tines.com/api/v1/admin/roles
  • Auth: one of:
    • API key in header X-User-Token
    • HTTP bearer

Request body

namestring required

Role name

descriptionstring

A description of the role

permissionsstring[] required

Permission names to apply to the role

Response

Successful response

idstring

Role ID

namestring

Role name

typestring

Role type, either custom or default

descriptionstring nullable

Role description

permissionsstring[]

Permission names applied to the role

created_atstring nullable

When the role was created. Null for default roles

updated_atstring nullable

When the role was last updated. Null for default roles

builderboolean

Whether the role grants builder / story editing permissions

Changes

No recorded changes to this operation across all 1 revision of this API.