Skip to main content
POST
/
api
/
v1
/
devices
/
{deviceId}
/
revoke
curl -X POST https://alfred.black/api/v1/devices/dev_x9y8z7w6v5/revoke \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

{
  "message": "Access revoked"
}
Revokes specific role-based access for a paired device without fully removing it. The device remains paired but loses access to operations requiring the revoked role.
This endpoint uses deviceId in the URL path (not requestId). This is the identifier of an already-paired device.
​
deviceId
string
required
The unique identifier of the paired device whose access should be revoked.
​
role
string
required
The role to revoke from the device. Valid values: agent, user, admin.
curl -X POST https://alfred.black/api/v1/devices/dev_x9y8z7w6v5/revoke \
  -H "Authorization: Bearer alf_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "admin"
  }'

{
  "message": "Access revoked"
}
​
message
string
A status message confirming the role access was revoked.