GET https://api.cryptohopper.com/v1/device/{device}/revoke

Revokes the authorization of one of your devices, so it has to be authorized again with an emailed code. The calling device must itself be authorized.

The handler checks no OAuth scope. The device record is kept with state 0 and a revokedAt time.

Example request

curl "https://api.cryptohopper.com/v1/device/DEVICE/revoke" \
  -H "access-token: YOUR_ACCESS_TOKEN"

Parameters

Headers

NameTypeRequiredDescription
access-token string Optional The OAuth access token of the user.

Path parameters

NameTypeRequiredDescription
device string Required The deviceId string of the device to revoke, as returned in the deviceId field of List your devices. The numeric id is not accepted.

Query parameters

NameTypeRequiredDescription
secret string Optional Optional two factor authentication code. When sent, it must be valid for the account or the request fails with 404 Wrong 2FA.

Response

Example response (illustrative values)

{
    "data": "ok"
}

Status codes: 200. Errors return JSON with status, error and message. See How the API works for response codes and rate limits.