Delete Authentication Token

DELETE /node/api/users/:id/auth-token

Deletes an authentication token for a user with the specified ID.

Permissions: manage-users.

Request parameters

Path parameters

Parameter

Type

Description

id

string

required

The ID of a user whose authentication token should be deleted.

Response description

...

Examples

Request examples

To delete an authentication token, you need to provide your login credentials along with your user id. The examples below show how this can be done using the Basic Access Authentication:

Bash
JavaScript
NodeJS
Python
Bash
login=<...>
password=<...>
user_id=<...>
saymon_hostname=<...>
url=https://$saymon_hostname/node/api/users/$user_id/auth-token
curl -X DELETE $url -u $login:$password
JavaScript
let login = <...>
let password = <...>
let userId = <...>
let saymonHostname = <...>
let path = "/node/api/users/" + userId + "/auth-token";
let auth = "Basic " + btoa(login + ":" + password);
let headers = new Headers();
headers.append("Authorization", auth);
let requestOptions = {
method: "DELETE",
headers: headers
};
fetch(saymonHostname + path, requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
NodeJS
const http = require("http");
let login = <...>
let password = <...>
let userId = <...>
let saymonHostname = <...>
let path = "/node/api/users/" + userId + "/auth-token";
let auth = "Basic " + Buffer.from(login + ":" + password).toString("base64");
let options = {
"method": "DELETE",
"hostname": saymonHostname,
"headers": {
Authorization: auth
},
"path": path
};
let req = http.request(options, function (res) {
let chunks = [];
res.on("data", function (chunk) {
chunks.push(chunk);
});
res.on("end", function (chunk) {
let body = Buffer.concat(chunks);
console.log(body.toString());
});
res.on("error", function (error) {
console.error(error);
});
});
req.end();
Python
import requests
login = <...>
password = <...>
user_id = <...>
saymon_hostname = <...>
url = "https://" + saymon_hostname + "/node/api/users/" + \
user_id + "/auth-token"
response = requests.request("DELETE", url, auth=(login, password))
print(response.text)