API Reference Revoke Session
Revoke Session
Sign one of your browser or stx CLI sessions out.
Session token
Signs one session out. The next request made with that session's token — browser or stx CLI — gets 401 session_revoked, and a browser session can no longer be refreshed.
Note
Requires a session JWT — a dashboard session or an stx login token. API keys are rejected with 401. You can only revoke your own sessions. Any plan.
Path Parameters
NameDescription
sessionIdThe session
id from List Sessions.You can revoke the session you are calling from. The request succeeds, and your next request gets 401 session_revoked.
Error Responses
401 Unauthorized
unauthorized for a missing, invalid or expired token (or an API key); session_revoked when the session you are calling from has been signed out.
404 Not Found
Returned when the id is unknown, already revoked, or belongs to another user — the API does not say which:
json
{
"error": {
"code": "not_found",
"message": "Session not found",
"details": { "traceId": "6f1c2a9e-3b7d-4c11-9a0e-2d5f8b4c7e10" }
}
}
Was this page helpful? Yes No
Previous
Request
cURLJavaScriptPythonGoRubyPHPJavaC#cURL
curl -X DELETE https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8 \
-H "Authorization: Bearer $SYNTEXT_JWT"
// A browser has no environment variables: set these to your values.
const SYNTEXT_JWT = '<SYNTEXT_JWT>';
const response = await fetch('https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8', {
method: 'DELETE',
headers: {
'Authorization': `Bearer ${SYNTEXT_JWT}`,
},
});
const data = await response.json();
console.log(response.status, data);
import os
import requests
url = "https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8"
headers = {
"Authorization": f"Bearer {os.environ['SYNTEXT_JWT']}",
}
response = requests.delete(url, headers=headers)
print(response.status_code)
print(response.json())
package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, err := http.NewRequest("DELETE", "https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8", nil)
if err != nil {
panic(err)
}
req.Header.Set("Authorization", "Bearer "+os.Getenv("SYNTEXT_JWT"))
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, err := io.ReadAll(res.Body)
if err != nil {
panic(err)
}
fmt.Println(res.Status)
fmt.Println(string(body))
}
require "net/http"
require "uri"
uri = URI("https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
request = Net::HTTP::Delete.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("SYNTEXT_JWT")}"
response = http.request(request)
puts response.code
puts response.body
<?php
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8',
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('SYNTEXT_JWT'),
],
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);
echo $status, PHP_EOL, $response, PHP_EOL;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8"))
.header("Authorization", "Bearer " + System.getenv("SYNTEXT_JWT"))
.DELETE()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
}
}
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Delete, "https://api.syntext.dev/v1/auth/sessions/c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8");
request.Headers.TryAddWithoutValidation("Authorization", "Bearer " + Environment.GetEnvironmentVariable("SYNTEXT_JWT"));
using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
Responseapplication/json
200OK
{
"data": {
"id": "c47e0b19-7a2d-4f61-8e35-6b90d2a1f7c8",
"revoked": true
}
}