List paired phones

GET

/devices

const url = 'http://127.0.0.1:7700/api/devices';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://127.0.0.1:7700/api/devices \
  --header 'Authorization: Bearer <token>'

Owner only. Phones that are paired and not revoked. Tokens are never listed. GET /pair/devices is the same route under its older name.

Authorizations

deviceToken
accessToken

Responses

200

The devices.

application/json

Array<object>

object

required

string

name

required

string

pairedAt

required

string format: date-time

owner

Paired as the owner’s device.

boolean

kind

What the device says it is. Absent for the web app. Not proof of anything.

string

Allowed values: iphone mac watch setup

person

Business: the person this device signs in as.

string

parent

A Watch’s iPhone.

string

identity

The device’s SpacetimeDB identity, if it gave one.

string

lastSeen

string format: date-time

push

Whether it turned notifications on.

boolean

Example

[
  {
    "id": "d4e5f6a7b8c",
    "kind": "iphone"
  }
]

403

The owner’s route, called by someone who is not the box’s own screen or a device paired as the owner.

application/json

object

error

required

What went wrong

string

Example

{
  "error": "only this computer's own screen or the owner's paired device can do this"
}