Announce Device

POST

devices

announce

curl -X POST https://api.usenaive.ai/v1/devices/announce \
  -H "Content-Type: application/json" \
  -d '{
    "claim_code": "TWR-4F2A-9CD1",
    "device_pubkey": "MCowBQYDK2VuAyEA...",
    "device_token_hash": "9f86d081884c7d65...",
    "name": "front-office-tower"
  }'

{
  "device_id": "dev_01H...",
  "status": "unclaimed"
}

Called by a Tower on first boot (by the device-agent firstboot subcommand). The box announces its claim code, its X25519 public key (used to seal inbound payloads to the box), and a hash of its device token. Unauthenticated — the claim code is the shared secret. Idempotent: a second announce with the same claim code returns 200 instead of 201.

Request Body

Parameter	Type	Required	Description
`claim_code`	string	Yes	The short claim code printed/shown at first boot
`device_pubkey`	string	Yes	The device’s X25519 public key (base64)
`device_token_hash`	string	Yes	SHA-256 hash of the device token
`name`	string	No	A friendly device name

curl -X POST https://api.usenaive.ai/v1/devices/announce \
  -H "Content-Type: application/json" \
  -d '{
    "claim_code": "TWR-4F2A-9CD1",
    "device_pubkey": "MCowBQYDK2VuAyEA...",
    "device_token_hash": "9f86d081884c7d65...",
    "name": "front-office-tower"
  }'

{
  "device_id": "dev_01H...",
  "status": "unclaimed"
}

Self-hosted only. In the cloud this route is inert. After announcing, the device polls GET /v1/devices/claim/{code} until an owner claims it. See claim & provisioning.

curl -X POST https://api.usenaive.ai/v1/devices/announce \
  -H "Content-Type: application/json" \
  -d '{
    "claim_code": "TWR-4F2A-9CD1",
    "device_pubkey": "MCowBQYDK2VuAyEA...",
    "device_token_hash": "9f86d081884c7d65...",
    "name": "front-office-tower"
  }'

{
  "device_id": "dev_01H...",
  "status": "unclaimed"
}

Overview

Endpoints

Announce Device

Request Body

​Request Body

Request Body