Announce
POST/api/v1/device-registry/announce
A unit says what it is. Unauthenticated, and hands out nothing.
202 on both branches, because the unit's behaviour is the same on both: it
keeps polling every 30 seconds until somebody claims it. A match refreshes a
PENDING row and names it; anything else lands in
unmanifested_announcements for a person to look at.
This is the one endpoint a device can reach before it has a credential, which is why the rate limiter runs before any query — see §6.1a, threat #1.
Request
Responses
- 202
- 422
Successful Response
Validation Error