Represents an account that a user belonging to your own 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 acts on behalf of your own organisation.
Currently, it is not possible for an application to create internal role accounts through this API. Instead, an administrator has to log in to the Lequinox console and create a role account there.
| Name | Description | Qualification | Schema |
|---|---|---|---|
| emailAddress | The email address of the user that this internal role account represents. | Required Read-only | string |
firstName | The first name of the user that this internal role account represents. | Required Read-only | string |
| id | The ID of the internal role account. | Required Read-only | string |
| lastName | The last name of the user that this internal role account represents. | Required Read-only | string |
| managed | Indicates if this internal role account should be managed by the platform or not. If set to true, the internal role account is activated by the platform on behalf of the user. A managed internal role account is an internal role account operated by the platform. For example, when an application requests the internal role account to sign a transaction, the platform signs the transaction on behalf of the user. On the other hand, an internal role account that is not managed is an internal role account that is operated by the user directly. For example, when the internal role account is to sign a transaction, the user signs the transaction using a PDI client. | Required Read-only | boolean |
personalIdentityId | The ID of the personal identity that this internal role account is linked to. This is set by the server during the role account activation. If the user has a proper personal identity, it 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 Read-only | string |
| roleId | The ID of the internal role that this internal role account belongs to. | Required Read-only | string |
| state | The state of the internal role account. INVITED: The internal role account has been created but not yet activated by the user. It cannot be used until the user has activated it. ACTIVE: The internal role account has been activated by the user and can be used. DEACTIVATED: The internal role account has been disabled and cannot be used. | Required Read-only | enum (INVITED, ACTIVE, DEACTIVATED) |