Activate user account

Activates a user account that was created with requirePasswordChange=true.
This endpoint validates the single-use activation token and allows the user to set their own password.

Applicable to ALL user types:

  • Tenant administrators (provisioned by platform admins)
  • Platform administrators (created by platform admins in tenant 001)
  • Regular users (created by tenant admins)
  • Any user account requiring password setup on first login

Process:

  1. Validates activation token (signature, expiration, purpose claim)
  2. Checks token hasn't been used (single-use via Redis blacklist)
  3. Updates user password with secure PBKDF2 hashing
  4. Marks account as active (removes requirePasswordChange flag)
  5. Adds token JTI to Redis blacklist to prevent reuse

Token Requirements:

  • Valid RS256 signature from Admin-API
  • Purpose claim = 'ACCOUNT_ACTIVATION'
  • Not expired (configurable, default: 24h)
  • Not previously used (checked via Redis blacklist)
  • Valid tenant and user UUIDs in claims

Security Model:
This endpoint enables zero-knowledge user provisioning where administrators never see
or know user passwords. Users set their own passwords, following OWASP ASVS 2.1.1
and industry best practices (AWS Cognito, Azure AD, Auth0 pattern).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Activation token and new password

Request to activate an administrator account and set a new password. Requires a valid single-use activation token obtained during tenant provisioning.

string
required
length ≥ 1

Single-use JWT activation token obtained from tenant provisioning response. This token contains the user ID, tenant ID, and other claims needed for activation. The token expires after 24 hours and can only be used once.

password
required
length between 12 and 128
^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[^a-zA-Z0-9]).{12,}$

New password for the administrator account. Must meet security requirements:

• Minimum 12 characters (OWASP ASVS 2.1.1 compliant)
• At least one uppercase letter (A-Z)
• At least one lowercase letter (a-z)
• At least one digit (0-9)
• At least one special character (any non-alphanumeric character)
• Maximum 128 characters

The password will be securely hashed using PBKDF2 before storage.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json