Skip to content
Aura Live Documentation

Create API Token

POST
/tokens

đŸ‘€ Authentification Utilisateur Requise

Ce point d’accĂšs permet Ă  l’utilisateur actuellement authentifiĂ© de crĂ©er un nouveau jeton d’API persistant. Ces jetons sont utilisĂ©s pour authentifier des requĂȘtes programmatiques Ă  l’API (par exemple, depuis un script, une application tierce, etc.) sans utiliser le mot de passe de l’utilisateur.

🚹 Attention : Sauvegardez votre Jeton !

Le jeton complet (full_token) n’est retournĂ© qu’une seule et unique fois, dans la rĂ©ponse de cette requĂȘte. Pour des raisons de sĂ©curitĂ©, il n’est pas stockĂ© en clair et il sera impossible de le rĂ©cupĂ©rer Ă  nouveau.

Copiez et sauvegardez ce jeton dans un endroit sûr immédiatement.

Example :

{
  "name": "My Awesome Tofken"
}

Authorizations

Section titled “Authorizations ”

Request Body

Section titled “Request Body ”
object
name

Un nom descriptif pour votre jeton (ex: “Script de reporting nocturne”).

string
expires_at
required

La date et l’heure d’expiration du jeton (format ISO 8601). Si omis, le jeton n’expirera jamais.

string
Examples

Responses

Section titled “ Responses ”

200

Section titled “200 ”

201

Section titled “201 ”

Successful response (inferred from assertions)

object
id
required

The unique numeric identifier for the token record. Use this ID to manage (e.g., delete) the token later.

integer
Example
42
name
required

The human-readable name provided by the user for this token, used for identification purposes.

string
Example
My Production Server Key
is_active
required

Indicates if the token is currently active. If false, any API request using this token will be rejected.

boolean
Example
true
expires_at
required

The ISO 8601 timestamp for when this token will automatically expire. A null value means the token never expires.

string format: date-time
nullable
Example
2026-01-01T00:00:00Z
last_used_at
required

The ISO 8601 timestamp of the last time this token was used to successfully authenticate. Will be null if never used.

string format: date-time
nullable
full_token
required

The complete, secret API token. IMPORTANT: This value is returned only once upon creation. You must copy and store it securely. It cannot be retrieved again.

string
Example
authotk_a1b2c3d4.abcdef1234567890abcdef1234567890abcdef1234567890abcdef123456
Example
{
  "id": 6,
  "name": "My Afwesome Token",
  "token_prefix": "authotk_62ad6f3f",
  "is_active": true,
  "expires_at": null,
  "last_used_at": null,
  "created_at": "2025-11-14T10:06:51.811521+01:00",
  "full_token": "authotk_62ad6f3f.fbafaeaafa1b70bc1d541245e7fc7672f4800fa35b350d2bf0024482ab9fdf60"
}