Table of Contents
> User object
The following objects are directly related to the user API.
User
The user object has the following properties.
| Property | Type | Description |
|---|---|---|
| userid | string | (readonly) ID of the user. |
| username (required) |
string | User name. |
| roleid (required) |
string | Role ID of the user. |
| attempt_clock | timestamp | (readonly) Time of the last unsuccessful login attempt. |
| attempt_failed | integer | (readonly) Recent failed login attempt count. |
| attempt_ip | string | (readonly) IP address from where the last unsuccessful login attempt came from. |
| autologin | integer | Whether to enable auto-login. Possible values: 0 - (default) auto-login disabled; 1 - auto-login enabled. |
| autologout | string | User session life time. Accepts seconds and time unit with suffix. If set to 0s, the session will never expire. Default: 15m. |
| lang | string | Language code of the user's language, for example, en_US.Default: default - system default. |
| name | string | Name of the user. |
| refresh | string | Automatic refresh period. Accepts seconds or time unit with suffix (e.g., 30s, 90s, 1m, 1h). Default: 30s. |
| rows_per_page | integer | Amount of object rows to show per page. Default: 50. |
| surname | string | Surname of the user. |
| theme | string | User's theme. Possible values: default - (default) system default;blue-theme - Blue;dark-theme - Dark. |
| url | string | URL of the page to redirect the user to after logging in. |
| timezone | string | User's time zone, for example, Europe/London, UTC.Default: default - system default.For the full list of supported time zones please refer to PHP documentation. |
| alias (deprecated) |
string | This property is deprecated, please use username instead.User alias. |
Note that for some methods (update, delete) the required/optional parameter combination is different.
Media
The media object has the following properties.
| Property | Type | Description |
|---|---|---|
| mediatypeid (required) |
string | ID of the media type used by the media. |
| sendto (required) |
string/array | Address, user name or other identifier of the recipient. If type of Media type is e-mail, values are represented as array. For other types of Media types, value is represented as a string. |
| active | integer | Whether the media is enabled. Possible values: 0 - (default) enabled; 1 - disabled. |
| severity | integer | Trigger severities to send notifications about. Possible bitmap values: 1 - Not classified; 2 - Information; 4 - Warning; 8 - Average; 16 - High; 32 - Disaster. This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 48 for Average, High, and Disaster). Default: 63. |
| period | string | Time when the notifications can be sent as a time period or user macros separated by a semicolon. Default: 1-7,00:00-24:00 |