Reset API token

POST/v1/me/reset-tokenFree

Issues a new API token. Once the request is processed successfully, the current token is invalidated immediately and only the new token works.

The same action is available from the bot.

Danger

The new token is only in the response body — save it, then distribute it to every client as soon as possible. After successful processing, the old token returns 401. If the connection is lost after the request was sent and you did not receive the new token, issue another token through the bot.

Authentication

Api-Key header with the current (about-to-be-replaced) token.

Request

No parameters, no body.

Examples

cURL

curl -X POST \
  -H "Api-Key: $API_KEY" \
  https://api.telesint.dev/v1/me/reset-token

Python

import os, requests

response = requests.post(
    "https://api.telesint.dev/v1/me/reset-token",
    headers={"Api-Key": os.environ["API_KEY"]},
    timeout=10,
)
response.raise_for_status()
new_token = response.json()["token"]

JavaScript

const res = await fetch('https://api.telesint.dev/v1/me/reset-token', {
  method: 'POST',
  headers: { 'Api-Key': process.env.API_KEY },
});
const { token: newToken } = await res.json();

Response — 200 OK

{
  "token": "abc123def456ghi789jkl012mno345pq"
}

Fields

Field	Type	Notes
token	string	New API token. Use as Api-Key in all subsequent requests.

Errors

Common error shapes — see Errors.