Skip to content

Register a device

POST
/devices/register

Called by Lander on startup. The request is signed with the device key. Idempotent — re-registering with the same certificate and owner is a no-op.

object
serialNumber
required
string
brand
string
Example
Apple
model
string
Example
Mac16,8
certificate
required

PEM-encoded device certificate

string
ownerEmail
string format: email
clientTimestamp
required
string format: date-time
signature
required

Base64 signature over the canonical payload

string

Device registered

object
deviceId
string format: uuid
certificateFingerprint
string
ownerAssigned
boolean

Invalid payload or signature