Represents an account that a user belonging to another organisation can use to act in a corporate role. Create this for your user if your association with them is professional (that is, the user acts for an organisation and not as a private person/in their personal identity), and if the user does not act on behalf of your own, but another organisation.
| Info |
|---|
The Lequinox platform does not archive transactions for external external role accounts as they represent another organisation. |
Name | Description | Qualification | Schema | ||
|---|---|---|---|---|---|
emailAddress | The email address of the user that this external role account represents. | Required | string | ||
firstName | The first name of the user that this external role account represents. | Required | string | ||
id | The ID of the external role account. It must not be specified during creation as it is generated by the server. | Required | string | ||
lastName | The last name of the user that this external role account represents. | Required | string | ||
managed | This must be set to true for the external role account to work as intended, and indicates that the account is activated and operated by the platform. For example, when an application requests the external role account to sign a transaction, the platform signs the transaction on behalf of the user.
| Required | boolean | ||
personalIdentityId | The ID of the personal identity that this external role account is linked to. This is set by the server during the role account activation. If the user has a proper personal identity, this ID is set to the ID of that personal identity. Otherwise an external personal identity is created for the user and the ID is set to that. | Optional | string | ||
roleId | The ID of the external role that this external role account belongs to.
| Required | string | ||
state | The state of the external role account. It must not be specified during creation as it is set by the server. The state of the external role account can be changed via the 'Update external role account' API. INVITED: The external role account has been created but not yet activated by the user. It cannot be used until the user has activated it. ACTIVE: The external role account has been activated by the user and can be used. DEACTIVATED: The external role account has been disabled and cannot be used.
| Required | enum (INVITED, ACTIVE, DEACTIVATED) |