ai.newnal.illi.device.link

The caller enters the device's onboarding code and becomes the root admin: creates the home and the family sphere on the caller's PDN with parent 1 and the caller as first members.

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

Procedure

procedure · POST

Input

application/json

code

requiredstring
  • maxLength: 16

The root admin's name as the family and the device see it (e.g. 김은수). Required by the family app; optional on the wire for compatibility.

  • maxLength: 64

homeId

string · tid

homeName

requiredstring
  • maxLength: 64

How the family calls parent 1 (e.g. 할머니, 어머니); written to the parentSlot record. Required by the family app.

  • maxLength: 32

Parent 1's name as the family and the device show it (e.g. 이순자); written to the parentSlot record. Required by the family app.

  • maxLength: 64

The root admin's relationship to the parents (e.g. 큰아들).

  • maxLength: 32

Output

application/json

homeId

requiredstring · tid

role

requiredstring
  • knownValues: rootAdmin

sphere

requiredstring

Errors

InvalidOnboardingCode

No description in schema.

CodeExpired

No description in schema.

DeviceAlreadyLinked

No description in schema.

ScopeMissing

No description in schema.

PdsUnavailable

No description in schema.

RateLimitExceeded

No description in schema.

Similar lexicons

semantic match

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

  • The root admin asks the device to create the second parent's Newnal ID (07 F-06); the name and honorific given here fill the new parentSlot. The device learns of it by SSE or getState.pendingRequests and completes it with account.parent.signIn {slot: 2}.

  • Register the device (device id, model) under parent 1's device-app session and issue a one-time onboarding code shown on the device.