Users API

Manage users in your Zalt realm.

Endpoints

GET/v1/admin/users

List all users in the realm

GET/v1/admin/users/:id

Get a specific user by ID

DELETE/v1/admin/users/:id

Delete a user

POST/v1/admin/users/:id/suspend

Suspend a user account

POST/v1/admin/users/:id/activate

Activate a suspended user

POST/v1/admin/users/:id/unlock

Unlock a locked account

POST/v1/admin/users/:id/reset-password

Admin password reset

POST/v1/admin/users/:id/mfa/reset

Reset user's MFA

User Object

{
  "id": "user_abc123",
  "email": "user@example.com",
  "emailVerified": true,
  "profile": {
    "firstName": "John",
    "lastName": "Doe",
    "avatar": "https://..."
  },
  "mfa": {
    "enabled": true,
    "methods": ["totp", "webauthn"]
  },
  "status": "active",
  "createdAt": "2026-01-25T10:00:00Z",
  "lastLoginAt": "2026-01-25T12:00:00Z"
}

Example: List Users

curl -X GET https://api.zalt.io/v1/admin/users \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "X-Realm-Id: your-realm-id"

// Response
{
  "users": [...],
  "pagination": {
    "total": 150,
    "page": 1,
    "limit": 20
  }
}