Skip to main content
POST
/
api
/
v1
/
devices
/
{requestId}
/
approve
curl -X POST https://alfred.black/api/v1/devices/req_7k9m3p2q1/approve \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "latest": true
  }'

{
  "message": "Device approved"
}
Approves a pending device pairing request, allowing the device to connect to your Alfred instance.
This endpoint uses requestId in the URL path, not deviceId. The request ID is the identifier of the pending pairing request, which is different from the device ID assigned after pairing.
​
requestId
string
required
The unique identifier of the pending pairing request to approve.
​
latest
boolean
default:false
If true, approves only the most recent request from this device. Prevents approval of stale requests.
curl -X POST https://alfred.black/api/v1/devices/req_7k9m3p2q1/approve \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "latest": true
  }'

{
  "message": "Device approved"
}
​
message
string
A status message confirming the device was approved.