Account Management

An account represents an administrative user in flexFS Enterprise and is used to authenticate with the admin server via configure.flexfs and the REST API. The admin server creates exactly one account, named Admin with the email admin@example.com, when it first initializes its database. Additional accounts cannot be created: configure.flexfs has no create account command, and the REST API refuses the request with 403. Update the account’s name and email as shown below.

Account Fields

Field	Type	Description
`id`	integer	Unique account identifier (auto-assigned)
`name`	string	Account display name
`email`	string	Contact email address
`token`	string	Authentication token (UUID)
`created_at`	timestamp	Account creation time

Listing Accounts

configure.flexfs list accounts

The list view displays id, name, and email.

Viewing Account Details

configure.flexfs show account <id>

The full detail view includes all fields, including the authentication token.

Updating an Account

Accounts support updating name, email, and token:

configure.flexfs update account <id> --name "Admin User" --email admin@example.com

To rotate an account’s authentication token:

configure.flexfs update account <id> --token <account-token>

Account Tokens

Each account has an authentication token (UUID) used to authenticate API requests. This token is stored in the configure.flexfs credentials file and passed in API request headers.

The account token is distinct from volume tokens, which grant mount access to specific volumes. Account tokens grant administrative access to the admin server API.

Multi-Tenancy

Volumes record the account that created them as account_id, and the volume-name endpoints used by the CSI driver enforce that ownership.