Ask to send this computer's setup

POST

/quickstart/send

curl --request POST \
  --url http://127.0.0.1:7700/api/quickstart/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "rv": "example", "pk": "example", "s": "example", "n": "example", "phonePk": "example", "keys": [ "example" ] }'

• On the box itself (the default listen address)
• From another device, with a paired device token, when BOX_LISTEN allows it

A phone paired as the owner, calling the computer it wants to copy from. Nothing leaves yet. The answer holds the exact question to put to the owner, naming the keys, the number of apps and the spending rules, and the check phrase to compare with the new computer’s screen.

Authorizations

• deviceToken
• accessToken

Request Body^required

Media typeapplication/json

object

rv

required

The rendezvous id from the QR code.

string

pk

required

The new computer’s public key from the QR code.

string

s

required

The secret from the QR code.

string

n

The new computer’s name.

string

<= 40 characters

phonePk

required

This phone’s one-time public key.

string

keys

The vault keys the owner ticked. Default: the model keys. Never a BOX_* key.

Array<string>

Example ^generated

{
  "rv": "example",
  "pk": "example",
  "s": "example",
  "n": "example",
  "phonePk": "example",
  "keys": [
    "example"
  ]
}

Responses

200

The question to ask.

Media typeapplication/json

object

id

required

string

phrase

required

string

question

required

string

keys

required

Array<object>

object

name

string

chosen

boolean

Example ^generated

{
  "id": "example",
  "phrase": "example",
  "question": "example",
  "keys": [
    {
      "name": "example",
      "chosen": true
    }
  ]
}

400

A field is missing or wrong.

Media typeapplication/json

object

error

required

What went wrong

string

Example ^generated

{
  "error": "example"
}

403

Not a phone paired as the owner.

Media typeapplication/json

object

error

required

What went wrong

string

Example ^generated

{
  "error": "example"
}