technitium 0.4.0

# Admin: Create User

## Endpoint

`/api/admin/users/create`

## Method

GET

## Description

Creates a new user account.

## Authentication

Required. Token must be provided via the `token` parameter.

## Permissions

Administration: Modify

## Parameters

| Name | Type | Required | Conditional | Description |
|------|------|----------|-------------|-------------|
| `token` | string | Yes | No | The session token generated by the `login` or the `createToken` call. |
| `user` | string | Yes | No | A unique username for the user account. |
| `pass` | string | Yes | No | A password for the user account. |
| `displayName` | string | No | No | The display name for the user account. |

## Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `displayName` | string | The display name of the created user. |
| `username` | string | The username of the created user. |
| `disabled` | boolean | Whether the user account is disabled (always `false` for new accounts). |
| `previousSessionLoggedOn` | string (datetime) | Timestamp of previous session (will be epoch zero for new accounts). |
| `previousSessionRemoteAddress` | string | Remote address of previous session (will be `0.0.0.0` for new accounts). |
| `recentSessionLoggedOn` | string (datetime) | Timestamp of recent session (will be epoch zero for new accounts). |
| `recentSessionRemoteAddress` | string | Remote address of recent session (will be `0.0.0.0` for new accounts). |

## Conditional Logic Notes

- The `user` parameter must be unique across all existing usernames.
- New accounts are always created in an enabled state (`disabled: false`).

## Edge Cases

- Session timestamps for newly created users are initialized to `0001-01-01T00:00:00` and addresses to `0.0.0.0` since they have never logged in.
- Attempting to create a user with an existing username will likely result in an error.