ai.newnal.illi.account.parent.startOAuth

illi-service.newnal.id

Documentation

Start a parent's OAuth sign-in on the device through the PDN's own page (BFF), for an existing Newnal ID whose credentials are typed on the PDN page. Device-created accounts, and existing ones whose credentials the device app takes itself, sign in with account.parent.signIn instead. client=native ends with a one-time code on the device app's App Link for account.exchangeCode instead of a cookie.

main procedure

Start a parent's OAuth sign-in on the device through the PDN's own page (BFF), for an existing Newnal ID whose credentials are typed on the PDN page. Device-created accounts, and existing ones whose credentials the device app takes itself, sign in with account.parent.signIn instead. client=native ends with a one-time code on the device app's App Link for account.exchangeCode instead of a cookie.

Input

Encodingapplication/json
client string Optional

web (default): the callback sets the device-app cookie. native: the callback redirects to the device app's App Link with a 60-second one-time code for account.exchangeCode.

codeChallenge string Optional

Required with client native: base64url(SHA-256(codeVerifier)) without padding. The one-time code the callback returns can only be exchanged with that verifier (account.exchangeCode).

maxLength: 43 bytesminLength: 43 bytes
deviceId string Optional

No description available.

maxLength: 64 bytes
mode string Required

No description available.

slot integer Optional

No description available.

minimum: 1maximum: 2

Output

Encodingapplication/json
loginUrl stringuri Required

A valid URI.

Errors

ParentLimitReached
ParentAlreadyLinked
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://bsky.social)
Enter valid JSON for the request body
View raw schema 
{
  "description": "Start a parent's OAuth sign-in on the device through the PDN's own page (BFF), for an existing Newnal ID whose credentials are typed on the PDN page. Device-created accounts, and existing ones whose credentials the device app takes itself, sign in with account.parent.signIn instead. client=native ends with a one-time code on the device app's App Link for account.exchangeCode instead of a cookie.",
  "errors": [
    {
      "name": "ParentLimitReached"
    },
    {
      "name": "ParentAlreadyLinked"
    }
  ],
  "input": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "client": {
          "default": "web",
          "description": "web (default): the callback sets the device-app cookie. native: the callback redirects to the device app's App Link with a 60-second one-time code for account.exchangeCode.",
          "knownValues": [
            "web",
            "native"
          ],
          "type": "string"
        },
        "codeChallenge": {
          "description": "Required with client native: base64url(SHA-256(codeVerifier)) without padding. The one-time code the callback returns can only be exchanged with that verifier (account.exchangeCode).",
          "maxLength": 43,
          "minLength": 43,
          "type": "string"
        },
        "deviceId": {
          "maxLength": 64,
          "type": "string"
        },
        "mode": {
          "knownValues": [
            "create",
            "signIn"
          ],
          "type": "string"
        },
        "slot": {
          "maximum": 2,
          "minimum": 1,
          "type": "integer"
        }
      },
      "required": [
        "mode"
      ],
      "type": "object"
    }
  },
  "output": {
    "encoding": "application/json",
    "schema": {
      "properties": {
        "loginUrl": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "loginUrl"
      ],
      "type": "object"
    }
  },
  "type": "procedure"
}

Lexicon Garden

@