Devices
Create WiFi Config Grant
Create a stateless grant for configuring WiFi credentials on a device via BLE
POST
Create a short-lived WiFi configuration grant that authorizes the companion app
to configure the device over BLE.
The SSID and password travel from the app to the device through the mobile SDK;
they are not sent to or stored by the Bota backend. The grant authorizes the
write but is not itself an encryption envelope.
Authentication
Requires an API key withdevices:write scope.
Path Parameters
string
required
The device’s unique identifier (e.g.,
dev_abc123).Request Body
integer
default:900
How long the grant is valid, in seconds. Minimum 60 (1 minute), maximum 3600 (1 hour). Default is 900 (15 minutes).
Response
Returns the grant blob and its expiration timestamp.Response Fields
Usage Flow
- App scans for WiFi networks — the SDK provides
scanNetworks()(Android) andgetCurrentSSID()(both platforms) so users can pick a network - App requests grant from your backend (this endpoint)
- App writes
grant_blobto the device’s Bluetooth WiFi Grant characteristic - App passes the SSID and password to the SDK
- SDK writes the release-compatible credential packet to the device
- Device connects to WiFi and reports status via the Bluetooth WiFi Status characteristic
scanNetworks() for step 1 and handles steps 3-6 automatically via BotaClient.devices.configureWiFi().

