Revoke a specific Authorization.
The earliest revocation will appear as the Authorization revoked
timestamp.
POST https://utilityapi.com/api/v2/authorizations/authorization_uid/revoke
# Revoke an Authorization (CANNOT BE UNDONE!) curl -X POST -H 'Authorization: Bearer API_TOKEN_HERE' \ 'https://utilityapi.com/api/v2/authorizations/1234/revoke'
No request body is required.
Returns the revoked Authorization object.
// Example returned Authorization { "uid": "12345", "created": "2016-01-01T12:30:24.653422+00:00", ... }
Code | Response Format | Description |
---|---|---|
200 |
Authorization | Successful request. |
401 |
Error |
Invalid or missing access_token . See our docs on
Authentication for
how to properly use your access_token .
|
404 |
Error | This Authorization doesn't exist or you don't have permissions to see it. |
429 |
N/A |
The request was rate limited.
Check the Retry-After response header for how long to wait
until retrying the request. Do not expect any specific response format for
this error (could be html, json, or nothing).
|
500 |
N/A | Internal server error. Do not expect any specific response format for this error (could be html, json, or nothing). This error is logged and will be fixed by our engineers. |
503 |
N/A | Site is currently down for maintenance. Do not expect any specific response format for this error (could be html, json, or nothing). |
504 |
N/A | We tried to build this request but timed out. Please try again later. Do not expect any specific response format for this error (could be html, json, or nothing). |