Authentification et compte
Inscription, connexion, double authentification, renouvellement de session, profil, sessions et préférences de notification de l’utilisateur connecté.
POST
/api/v1/auth/accept-invitation POST /api/v1/auth/forgot-password POST /api/v1/auth/login POST /api/v1/auth/login/2fa POST /api/v1/auth/login/2fa/enrollment POST /api/v1/auth/login/password-change POST /api/v1/auth/logout GET /api/v1/auth/me PATCH /api/v1/auth/me DELETE /api/v1/auth/me/2fa POST /api/v1/auth/me/2fa/confirm POST /api/v1/auth/me/2fa/setup POST /api/v1/auth/me/activity GET /api/v1/auth/me/notifications PATCH /api/v1/auth/me/notifications PATCH /api/v1/auth/me/password GET /api/v1/auth/me/sessions DELETE /api/v1/auth/me/sessions/{sessionId} POST /api/v1/auth/refresh POST /api/v1/auth/register POST /api/v1/auth/reset-password GET /api/v1/auth/validate-invitation POST /api/v1/auth/accept-invitation
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 3 requêtes par minute et par adresse IP (budget partagé entre inscription et acceptation d’invitation)
Corps de la requête
application/json, requis
Schéma AcceptInvitationRequest
| Champ | Type | Contraintes |
|---|---|---|
token requis | string | — |
firstName requis | string | null | — |
lastName requis | string | null | — |
password requis | string | null | — |
Réponse
200 · application/json
Schéma AcceptInvitationResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresSignIn | boolean | — |
email | string | — |
organizationName | string | — |
POST /api/v1/auth/forgot-password
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 3 requêtes par minute et par adresse IP
Corps de la requête
application/json, requis
Schéma ForgotPasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/auth/login
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 5 requêtes par minute et par adresse IP (budget partagé avec la vérification du second facteur)
Corps de la requête
application/json, requis
Schéma LoginRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
password requis | string | max. 200 caractères |
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/login/2fa
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 5 requêtes par minute et par adresse IP (budget partagé avec la vérification du second facteur)
Corps de la requête
application/json, requis
Schéma TwoFactorLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
twoFactorToken requis | string | — |
code requis | string | — |
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/login/2fa/enrollment
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 5 requêtes par minute et par adresse IP (budget partagé avec la vérification du second facteur)
Corps de la requête
application/json, requis
Schéma TwoFactorEnrollmentLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
challengeToken requis | string | — |
code requis | string | — |
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/login/password-change
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 5 requêtes par minute et par adresse IP (budget partagé avec la vérification du second facteur)
Corps de la requête
application/json, requis
Schéma PasswordChangeLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
challengeToken requis | string | — |
currentPassword requis | string | max. 200 caractères |
newPassword requis | string | max. 200 caractères |
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/logout
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/auth/me
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse
200 · application/json
Schéma UserProfileResponse
| Champ | Type | Contraintes |
|---|---|---|
id | string (uuid) | — |
email | string | — |
emailVerified | boolean | — |
firstName | string | — |
lastName | string | — |
avatarUrl | string | null | — |
organizationId | string (uuid) | — |
organizationName | string | — |
roles | EntityRoleDto[] | — |
rootEntityId | string (uuid) | null | — |
onboardingCompleted | boolean | — |
onboardingStep | string | null | — |
twoFactorEnabled | boolean | — |
isPlatformAdmin | boolean | — |
passwordPolicy | UserPasswordPolicyDto | — |
PATCH /api/v1/auth/me
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Corps de la requête
application/json, requis
Schéma UpdateProfileRequest
| Champ | Type | Contraintes |
|---|---|---|
firstName | string | null | — |
lastName | string | null | — |
preferredLanguage | string | null | — |
timezone | string | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
DELETE /api/v1/auth/me/2fa
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Corps de la requête
application/json, requis
Schéma TwoFactorDisableRequest
| Champ | Type | Contraintes |
|---|---|---|
password requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/auth/me/2fa/confirm
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Corps de la requête
application/json, requis
Schéma TwoFactorConfirmRequest
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/auth/me/2fa/setup
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse
200 · application/json
Schéma TwoFactorSetupResponse
| Champ | Type | Contraintes |
|---|---|---|
secret requis | string | — |
qrCodeUri requis | string | — |
qrCodeImage requis | string | — |
backupCodes requis | string[] | — |
POST /api/v1/auth/me/activity
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse
200 · application/json
Schéma SessionInfoDto
| Champ | Type | Contraintes |
|---|---|---|
id requis | string (uuid) | — |
expiresAt requis | string (date-time) | — |
idleExpiresAt requis | string (date-time) | — |
maxDurationHours requis | integer | — |
inactivityTimeoutMinutes requis | integer | — |
GET /api/v1/auth/me/notifications
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PATCH /api/v1/auth/me/notifications
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Corps de la requête
application/json, requis
Schéma UpdateNotificationPreferencesRequest
| Champ | Type | Contraintes |
|---|---|---|
assignmentEmails requis | string | null | — |
deadlineEmails requis | string | null | — |
overdueEmails requis | string | null | — |
automationEmails requis | string | null | — |
digestFrequency requis | string | null | — |
disabledModules requis | string[] | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PATCH /api/v1/auth/me/password
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- 5 requêtes par minute et par utilisateur
Corps de la requête
application/json, requis
Schéma ChangePasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
currentPassword requis | string | — |
newPassword requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/auth/me/sessions
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Réponse
200 · application/json
Type SessionResponse[]
DELETE /api/v1/auth/me/sessions/{sessionId}
- Accès
- Utilisateur authentifié (
Authorization: Bearer), sans permission particulière. - Limite de débit
- aucune
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
sessionId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/auth/refresh
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 60 requêtes par minute et par adresse IP
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/register
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 3 requêtes par minute et par adresse IP (budget partagé entre inscription et acceptation d’invitation)
Corps de la requête
application/json, requis
Schéma RegisterRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
password requis | string | min. 12 caractères · max. 200 caractères |
firstName requis | string | max. 100 caractères |
lastName requis | string | max. 100 caractères |
organizationName requis | string | max. 255 caractères |
Réponse
200 · application/json
Schéma AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
POST /api/v1/auth/reset-password
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- 5 requêtes par minute et par adresse IP
Corps de la requête
application/json, requis
Schéma ResetPasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
token requis | string | max. 2048 caractères |
newPassword requis | string | min. 12 caractères · max. 200 caractères |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/auth/validate-invitation
- Accès
- Anonyme : aucun jeton requis.
- Limite de débit
- aucune
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
token | requête | string | — |
Réponse
200 · application/json
Schéma ValidateInvitationResponse
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | — |
organizationName requis | string | — |
roles requis | InvitationRoleDto[] | — |
isExistingUser requis | boolean | — |
passwordMinLength requis | integer | — |
Schémas
Objets utilisés par les opérations de cette page. Les nombres sont écrits en JSON comme des nombres ; les énumérations, comme des chaînes.
AcceptInvitationRequest
| Champ | Type | Contraintes |
|---|---|---|
token requis | string | — |
firstName requis | string | null | — |
lastName requis | string | null | — |
password requis | string | null | — |
AcceptInvitationResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresSignIn | boolean | — |
email | string | — |
organizationName | string | — |
SessionInfoDto
| Champ | Type | Contraintes |
|---|---|---|
id requis | string (uuid) | — |
expiresAt requis | string (date-time) | — |
idleExpiresAt requis | string (date-time) | — |
maxDurationHours requis | integer | — |
inactivityTimeoutMinutes requis | integer | — |
ForgotPasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
LoginRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
password requis | string | max. 200 caractères |
AuthResponse
| Champ | Type | Contraintes |
|---|---|---|
accessToken | string | — |
expiresIn | integer | — |
session | SessionInfoDto | null | — |
requiresTwoFactor | boolean | — |
twoFactorToken | string | null | — |
requiredStep | string | null | — |
challengeToken | string | null | — |
twoFactorEnrollment | TwoFactorEnrollmentSetup | null | — |
passwordChange | PasswordChangeRequirement | null | — |
TwoFactorEnrollmentSetup
| Champ | Type | Contraintes |
|---|---|---|
secret requis | string | — |
qrCodeUri requis | string | — |
qrCodeImage requis | string | — |
PasswordChangeRequirement
| Champ | Type | Contraintes |
|---|---|---|
reason requis | string | — |
minLength requis | integer | — |
historyCount requis | integer | — |
TwoFactorLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
twoFactorToken requis | string | — |
code requis | string | — |
TwoFactorEnrollmentLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
challengeToken requis | string | — |
code requis | string | — |
PasswordChangeLoginRequest
| Champ | Type | Contraintes |
|---|---|---|
challengeToken requis | string | — |
currentPassword requis | string | max. 200 caractères |
newPassword requis | string | max. 200 caractères |
UserProfileResponse
| Champ | Type | Contraintes |
|---|---|---|
id | string (uuid) | — |
email | string | — |
emailVerified | boolean | — |
firstName | string | — |
lastName | string | — |
avatarUrl | string | null | — |
organizationId | string (uuid) | — |
organizationName | string | — |
roles | EntityRoleDto[] | — |
rootEntityId | string (uuid) | null | — |
onboardingCompleted | boolean | — |
onboardingStep | string | null | — |
twoFactorEnabled | boolean | — |
isPlatformAdmin | boolean | — |
passwordPolicy | UserPasswordPolicyDto | — |
EntityRoleDto
| Champ | Type | Contraintes |
|---|---|---|
entityId | string (uuid) | — |
entityName | string | — |
role | string | — |
UserPasswordPolicyDto
| Champ | Type | Contraintes |
|---|---|---|
minLength requis | integer | — |
historyCount requis | integer | — |
expiresAt requis | string (date-time) | null | — |
expiryWarningDays requis | integer | — |
UpdateProfileRequest
| Champ | Type | Contraintes |
|---|---|---|
firstName | string | null | — |
lastName | string | null | — |
preferredLanguage | string | null | — |
timezone | string | null | — |
TwoFactorDisableRequest
| Champ | Type | Contraintes |
|---|---|---|
password requis | string | — |
TwoFactorConfirmRequest
| Champ | Type | Contraintes |
|---|---|---|
code requis | string | — |
TwoFactorSetupResponse
| Champ | Type | Contraintes |
|---|---|---|
secret requis | string | — |
qrCodeUri requis | string | — |
qrCodeImage requis | string | — |
backupCodes requis | string[] | — |
UpdateNotificationPreferencesRequest
| Champ | Type | Contraintes |
|---|---|---|
assignmentEmails requis | string | null | — |
deadlineEmails requis | string | null | — |
overdueEmails requis | string | null | — |
automationEmails requis | string | null | — |
digestFrequency requis | string | null | — |
disabledModules requis | string[] | null | — |
ChangePasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
currentPassword requis | string | — |
newPassword requis | string | — |
SessionResponse
| Champ | Type | Contraintes |
|---|---|---|
id requis | string (uuid) | — |
ipAddress requis | string | null | — |
userAgent requis | string | null | — |
lastActivityAt requis | string (date-time) | null | — |
createdAt requis | string (date-time) | — |
isCurrent requis | boolean | — |
expiresAt requis | string (date-time) | — |
idleExpiresAt requis | string (date-time) | — |
RegisterRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
password requis | string | min. 12 caractères · max. 200 caractères |
firstName requis | string | max. 100 caractères |
lastName requis | string | max. 100 caractères |
organizationName requis | string | max. 255 caractères |
ResetPasswordRequest
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | max. 255 caractères |
token requis | string | max. 2048 caractères |
newPassword requis | string | min. 12 caractères · max. 200 caractères |
ValidateInvitationResponse
| Champ | Type | Contraintes |
|---|---|---|
email requis | string | — |
organizationName requis | string | — |
roles requis | InvitationRoleDto[] | — |
isExistingUser requis | boolean | — |
passwordMinLength requis | integer | — |
InvitationRoleDto
| Champ | Type | Contraintes |
|---|---|---|
entityId requis | string (uuid) | — |
entityName requis | string | — |
role requis | string | — |
Mise à jour : 10 octobre 2026. Signaler une inexactitude