DELETE User sessions & access

Revoke all user tokens

Revoke every bearer token previously issued for a user.

DELETE /api/v3/{appid}/user/users/{userid}/tokens

Revoke every bearer token previously issued for a user.

Call this endpoint from your trusted backend. Tokens issued before the revocation cutoff stop being accepted, including tokens minted by TalkLabs and compatible tokens signed by your own identity system.

Request

Parameters

Values in the path and query string.

appid path

string TalkLabs ID required

The application the user belongs to.

Example: your-app-id

userid path

string customer-defined required

The user whose tokens are being revoked.

Example: u-8842

Response

Status codes

Every JSON response uses the API result envelope.

200 OK ApiResult

400 Bad Request ApiResult

401 Unauthorized ApiResult

404 Not Found ApiResult

500 Internal Server Error ApiResult

curl --request DELETE \
  --url "https://api.sportstalk247.com/api/v3/${APP_ID}/user/users/${USER_ID}/tokens" \
  --header "Accept: application/json" \
  --header "x-api-token: ${TALKLABS_API_TOKEN}"

const appId = process.env.TALKLABS_APP_ID;
const userid = 'u-8842';

const response = await fetch(
  `https://api.sportstalk247.com/api/v3/${appId}/user/users/${userid}/tokens`,
{
  method: 'DELETE',
  headers: {
    Accept: 'application/json',
    'x-api-token': process.env.TALKLABS_API_TOKEN,
  },
});

const result = await response.json();

import json
import os
import requests

app_id = os.environ["TALKLABS_APP_ID"]
userid = "u-8842"

response = requests.delete(
    f"https://api.sportstalk247.com/api/v3/{app_id}/user/users/{userid}/tokens",
    headers={
        "Accept": "application/json",
        "x-api-token": os.environ["TALKLABS_API_TOKEN"],
    },
)
response.raise_for_status()
result = response.json()

Environment variables TALKLABS_APP_ID TALKLABS_API_TOKEN

Response