roles

Create a role

Changed on

Create a new role with optional initial permissions, named by id or by resource_type:action key. The body may be JSON or YAML.

post/api/v1/roles

Request

  • The document declares no server URL.
  • Auth
    • API key in header X-API-Key
    • or API key in header Authorization

Request body

descriptionstring
namestring
permission_idsstring[]
permission_keysstring[]

PermissionKeys names permissions as resource_type:action keys, the form a hand-written role document uses.

Response

OK

created_atstring
deleted_atstring
descriptionstring
idstring
is_systemboolean
namestring
permission_keysstring[]

PermissionKeys are the same permissions as resource_type:action keys, the form a role document is written in.

updated_atstring
user_countinteger

Changes

  • 0bd802afff21Revision changes
    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security BearerAuth was added to the API