Skip to main content
DELETE
/
devices
/
users
/
{userId}
/
{deviceId}
curl -X DELETE "https://api.tktchurch.com/v1/devices/users/123e4567-e89b-12d3-a456-426614174000/456e789a-b12d-3456-789a-bcdef0123456" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
This endpoint requires authentication and the viewUserDevices permission.

​
Path Parameters

​
userId
string
required
The UUID of the user whose device to revoke
​
deviceId
string
required
The UUID of the device token to revoke

​
Response

A successful request returns HTTP 204 No Content status. The following actions are performed:
  1. The device’s refresh token is blacklisted
  2. Any associated access tokens are blacklisted
  3. The tokens are removed from the database

​
Error Responses

​
error
object
Error details when the request fails
Common error cases:
  • 400 Bad Request: Invalid user ID or device ID format
  • 401 Unauthorized: Missing or invalid access token
  • 403 Forbidden: Insufficient permissions (missing viewUserDevices)
  • 404 Not Found: User or device not found
curl -X DELETE "https://api.tktchurch.com/v1/devices/users/123e4567-e89b-12d3-a456-426614174000/456e789a-b12d-3456-789a-bcdef0123456" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."