Creates a Token that represents arbitrary encrypted data saved on the Backbone.

Parameters

  • content an arbitrary JSON structure of the data to share via the Token.
  • expiresAt is the ISODateTime the Token expires at.
  • ephemeral indicates if the Token should be ephemeral and thus not be stored and cached on the local database. This is especially useful for Tokens which are created regularly, e.g. for RelationshipTemplates and doesn’t need to be stored.
  • forIdentity can be set to an enmeshed address. If set, only the Identity with that address can load the Token from the Backbone.
  • passwordProtection can be specified as an object for PasswordProtection of a Token. If set, only the Identities that know the password specified within the passwordProtection.password property of the Token can load it from the Backbone. In addition, the optional property passwordProtection.passwordIsPin can be used to configure the UI of the App in case the password is a pin.

On Success

  • Returns the created Token.

On Failure

  • The content is malformed.
  • expiresAt lies in the past.
  • In case of password protection of the Token, a passwordProtection.password that does not consist of 4 to 16 digits was specified, but the value of passwordProtection.passwordIsPin was nevertheless set to true.

How to execute this use case with the Connector?

The Connector is our first-class citizen, thus we provide you with a detailed API description for every use case. This use case can be executed with the REST API of the Connector which you can Access the Connector.
Corresponding interactive API docs excerpt: