Roles

Create a tenant role

Changed on

Only a user of the tenant primary account may create roles (403 otherwise). The role may not be ranked above the caller (lower rank is more privileged). It may contain any permission in the catalogue: holding Roles.Manage is enough, the caller need not hold them. The name must be unique in the tenant and may not be a predefined role's name. To duplicate a role, read it and post its permissions under a new name.

post/v1/Roles/definitions

Request

  • Base URL
    https://api.invendor.com (the document declares no server; this is the origin it was published from)
  • Auth
    OAuth 2
    Authorization codehttps://identity.scanbro.com/connect/authorize
    Token URLhttps://identity.scanbro.com/connect/token
    Scopesio.common
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

Accountunknown

Account

Request body

namestring nullable
descriptionstring nullable
rankinteger
permissionsstring[] nullable

Response

Created

idstring nullable
namestring nullable
descriptionstring nullable
rankinteger
isSystemboolean
permissionsstring[] nullable
holderCountinteger
canEditboolean
canDeleteboolean
canAssignboolean

Changes