The method user/revoke_tokens revokes OAuth tokens belonging to a specific user. You can use the method /user/list to look up the ID of the user whose tokens you want to revoke.
HTTP request syntax (URI)
POST https://host_ip:9099/mapi/v1/user/revoke_tokens
Request structure
The request body is:
{
"id": "uuid"
}
| Parameter | Required | Type | Description |
|---|---|---|---|
| id | Yes | UUID | The UUID of the user whose OAuth credentials you are revoking. |
Response structure
Not applicable.
Return codes
|
Status code |
HTTP name |
Description |
|---|---|---|
| 200 | OK | The request was executed successfully. |
| 400 | Bad Request | User ID not valid. |
| 401 | Unauthorized | Access was denied because credentials are not valid. |
| 404 | Not Found | The user ID was not found. |
| 405 | Method Not Allowed | The specified HTTP method is not allowed for user data. Resend using POST. |
Example
Request example:
POST https://10.10.24.195:9099/mapi/v1/user/revoke_tokens
JSON request:
{
"id": "3fa85f64-1024-1954-b3fc-2c963f66afa6"
}