ai.newnal.illi.phone.registerIdentity

Register the caller's Private Phone account (Matrix user ID). Called by a family member from the family app, or by the device with parent 1's device-app session for the account the device calls with. The MXID is taken to belong to the signed-in caller; there is no proof of control. The client creates the account by DID sign-in on a Messaging Node and writes the ILLI enrollment marker first. The Service Agent Node records phoneIdentity in the caller's family spheres and starts room provisioning; calling it again with the same MXID asks for a new provisioning run.

Details · procedure
Kindprocedure
Authorityphone.illi.newnal.ai
Indexed

Procedure

procedure · POST

Input

application/json

mxid

requiredstring

Matrix user ID on one of the Service Agent Node's supported homeservers.

  • maxLength: 255

Output

application/json

mxid

requiredstring

Matrix user ID, @localpart:server name.

  • maxLength: 255

Errors

UnsupportedHomeserver

The MXID is malformed or its server is not in the supported homeserver list.

IdentityTaken

The MXID is registered to another account.

PhoneNotAllowed

Parents call through the device: a parent's account from a family session, or a parent other than the device's signed-in parent.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • The author's Private Phone account, identified by its Matrix ID (the server name is part of the MXID). One account per person: a family member's appears in every family sphere the member belongs to, and parent 1's is the account the ILLI device calls with (parent 2 has none). Written by the Service Agent Node after phone.registerIdentity.

  • Registry entry for a Private Phone room of this home, written by the ILLI Service Agent Node with the root admin's session after it created the room through the Messaging Node's Admin API: the home's group room or a direct room between a member and parent 1.

  • The home's group room: the device and every family member.