Managing user accounts

All operations with user accounts in the cloud platform are located under the /users endpoint.

User accounts represent the users registered on the platform.

User accounts created in a customer tenant have a personal tenant. Personal tenant represents a tenant bound to a specific user account, and is used only to control user account quotas and to collect user account real usage.

JSON object structure of a user account

Name

Value type

Description

id

UUID string

The UUID of the user account.

version

number

Revision number.

tenant_id

UUID string

The UUID of the tenant where the user account was created.

login

string

A login of the user account.

contact

contact object

The contact information of the account.

activated

boolean (default false)

Activation status of the user.

enabled

boolean (default true)

Flag, that disables or enables user account in the platform.

terms_accepted

boolean (default false)

Flag, that shows if the user accepted legal terms.

created_at

string

ISO 8601 date and time when the user was created.

language

string

User’s language.

idp_id

string

External identity provider UUID.

external_id

string

User UUID in external identity provider (if the user was created through external identity provider).

personal_tenant_id

string

Personal tenant UUID (if the user was created in the customer tenant). This tenant includes user account contact information and has kind set to unit.

notifications

array of strings

User’s subscriptions for notifications.

mfa_status

string

User’s two-factor authentication (2FA) status. See available 2FA statuses.

User account contact object structure

Name

Value type

Description

email

string

An email address that will be used for account activation and service notifications.

types

string

A type of contact:
  • billing - a contact that will get updates about important changes in usage reporting in the platform. There can be several Billing contacts per tenant.

  • management - a contact that will get updates about important business-related changes in the platform. There can be several Business contacts per tenant.

  • technical - a contact that will get updates about important technical changes in the platform. There can be several Technical contacts per tenant.

address1

string

Address line 1.

address2

string

Address line 2.

country

string

User’s country.

state

string

User’s state.

zipcode

string

User’s zip code.

city

string

User’s city.

phone

string

User’s phone number.

firstname

string

The first name of the user.

lastname

string

The last name of the user.

Example user account

{
  "id": "948efcf2-b740-4c40-bb2d-4e4a46adfd87",
  "version": 2,
  "tenant_id": "0ef03214-6e47-4e50-87f2-a5955ba6095c",
  "login": "mylogin",
  "contact": {
    "email": "me@mysite.com",
    "address1": "1440 River Drive #100",
    "address2": "",
    "country": "USA",
    "state": "CA",
    "zipcode": "12345",
    "city": "Rivertown",
    "phone": "123456789",
    "firstname": "John",
    "lastname": "Doe",
    "types": ["billing", "management", "technical"]
  },
  "activated": true,
  "enabled": true,
  "terms_accepted": false,
  "created_at": "2019-07-25T07:11:02.807354+00:00",
  "language": "en",
  "idp_id": "e6f73a28-ff2e-4728-8f78-49eb74b20fce",
  "external_id": "S-1-5-21-917267712-1342860078-1792151419-500",
  "personal_tenant_id": "2f8ad2e2-28f2-11e7-aad1-5ffe2ad47151",
  "business_types": [],
  "notifications": [
    "quota",
    "reports",
    "backup_error",
    "backup_warning",
    "backup_info",
    "backup_daily_report"
  ],
  "mfa_status": "setup_required"
}

Available user account notifications

Value

Description

quota

Notifications regarding quota overuse.

reports

Notifications regarding scheduled usage reports.

backup_error

Notifications regarding backup errors.

backup_warning

Notifications regarding backup warnings.

backup_info

Notifications regarding successful backup.

backup_daily_report

Notifications with daily recap about active alerts.

Available two-factor authentication (2FA) statuses

Value

Description

disabled

Tenant has disabled 2FA and user is not required to use it in order to log in.

setup_required

Tenant has enabled 2FA and user is required to configure it in order to log in.

enabled

Tenant has enabled 2FA and user has it configured.

forcibly_disabled

Force disables 2FA for the user account. Only used for service accounts.

What you can do with user accounts

Operation

Methods and endpoints used

GET /users/check_login
POST /users
GET /users/{user_id}
POST /users/{user_id}/send-activation-email
POST /users/{user_id}/password
GET /users/{user_id}/access_policies
PUT /users/{user_id}/access_policies
GET /users/{user_id}
POST /users/{user_id}/password
PUT /users/{user_id}
PUT /users/{user_id}
PUT /users/{user_id}
DELETE /users/{user_id}