Claim a device
POST/devices/claim
Claims a device for a tenant-owned Location using its confirmation code. Restricted to an authenticated human WorkOS admin session — an M2M credential with device:devices:write is not sufficient. Rate-limited per admin session. Validates the confirmation code against loom-loyalty's external claim callback before the device is created.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 429
- 502
Device claimed
Invalid or expired confirmation code
Unauthorized
Forbidden
Location not found
Device already claimed
Too many claim attempts
Claim validation temporarily unavailable