Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NameDescriptionQualificationSchema
emailAddress

The email address of the user that this external role account represents.

Requiredstring

firstName

The first name of the user that this external role account represents.

Required

string

 id

The identifier of the external role account. It must not be specified during creation as it is generated by the server.

Required
Read-only
string
lastName

The last name of the user that this external role account represents.

Requiredstring
managed

Indicates if this external role account should be managed by the platform or not. If set to true, then this external role account is activated by the platform on behalf of the user. A managed external role account is an external role account 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. On the other hand, an external role account that is not managed is an external role account operated by the user directly. For example, when the external role account is to sign a transaction, the user signs the transaction using a PDI client.

Info

This cannot be changed after the external role account has been created.


Required
Read-only
boolean

personalIdentityId

The ID identifier 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 identifier is set to the ID identifier of that personal identity. Otherwise an external personal identity is created for the user and the ID identifier is set to that.

Optional
Read-only
string
roleId

The ID identifier of the external role that this external role account belongs to. 

Info

This cannot be changed after the external role account has been created.


Required
Read-only
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.

Info

The state can only be changed from ACTIVE to DEACTIVATED or from DEACTIVATED to ACTIVE.


Required

enum (INVITED, ACTIVE, DEACTIVATED)

...