Module system_api

Source

Enums§

CheckIntegrityError
struct for typed errors of method check_integrity
ClearServerBusyError
struct for typed errors of method clear_server_busy
DatabaseRecycleError
struct for typed errors of method database_recycle
GenerateSupportPacketError
struct for typed errors of method generate_support_packet
GetAnalyticsOldError
struct for typed errors of method get_analytics_old
GetAuditsError
struct for typed errors of method get_audits
GetClientConfigError
struct for typed errors of method get_client_config
GetClientLicenseError
struct for typed errors of method get_client_license
GetConfigError
struct for typed errors of method get_config
GetEnvironmentConfigError
struct for typed errors of method get_environment_config
GetImageByUrlError
struct for typed errors of method get_image_by_url
GetLogsError
struct for typed errors of method get_logs
GetNoticesError
struct for typed errors of method get_notices
GetPingError
struct for typed errors of method get_ping
GetPrevTrialLicenseError
struct for typed errors of method get_prev_trial_license
GetRedirectLocationError
struct for typed errors of method get_redirect_location
GetServerBusyExpiresError
struct for typed errors of method get_server_busy_expires
GetSupportedTimezoneError
struct for typed errors of method get_supported_timezone
GetWarnMetricsStatusError
struct for typed errors of method get_warn_metrics_status
InvalidateCachesError
struct for typed errors of method invalidate_caches
MarkNoticesViewedError
struct for typed errors of method mark_notices_viewed
PatchConfigError
struct for typed errors of method patch_config
PostLogError
struct for typed errors of method post_log
ReloadConfigError
struct for typed errors of method reload_config
RemoveLicenseFileError
struct for typed errors of method remove_license_file
RequestLicenseRenewalLinkError
struct for typed errors of method request_license_renewal_link
RequestTrialLicenseError
struct for typed errors of method request_trial_license
RestartServerError
struct for typed errors of method restart_server
SendTrialLicenseWarnMetricAckError
struct for typed errors of method send_trial_license_warn_metric_ack
SendWarnMetricAckError
struct for typed errors of method send_warn_metric_ack
SetServerBusyError
struct for typed errors of method set_server_busy
TestEmailError
struct for typed errors of method test_email
TestS3ConnectionError
struct for typed errors of method test_s3_connection
TestSiteUrlError
struct for typed errors of method test_site_url
UpdateConfigError
struct for typed errors of method update_config
UpdateMarketplaceVisitedByAdminError
struct for typed errors of method update_marketplace_visited_by_admin
UpgradeToEnterpriseError
struct for typed errors of method upgrade_to_enterprise
UpgradeToEnterpriseStatusError
struct for typed errors of method upgrade_to_enterprise_status
UploadLicenseFileError
struct for typed errors of method upload_license_file

Functions§

check_integrity
Performs a database integrity check. Note: This check may temporarily harm system performance. Minimum server version: 5.28.0 Local mode only: This endpoint is only available through local mode.
clear_server_busy
Marks the server as not having high load which re-enables non-critical services such as search, statuses and typing notifications. Minimum server version: 5.20 ##### Permissions Must have manage_system permission.
database_recycle
Recycle database connections by closing and reconnecting all connections to master and read replica databases. ##### Permissions Must have manage_system permission.
generate_support_packet
Download a zip file which contains helpful and useful information for troubleshooting your mattermost instance. Minimum server version: 5.32 ##### Permissions Must have any of the system console read permissions. ##### License Requires either a E10 or E20 license.
get_analytics_old
Get some analytics data about the system. This endpoint uses the old format, the /analytics route is reserved for the new format when it gets implemented. The returned JSON changes based on the name query parameter but is always key/value pairs. Minimum server version: 4.0 ##### Permissions Must have manage_system permission.
get_audits
Get a page of audits for all users on the system, selected with page and per_page query parameters. ##### Permissions Must have manage_system permission.
get_client_config
Get a subset of the server configuration needed by the client. ##### Permissions No permission required.
get_client_license
Get a subset of the server license needed by the client. ##### Permissions No permission required but having the manage_system permission returns more information.
get_config
Retrieve the current server configuration ##### Permissions Must have manage_system permission.
get_environment_config
Retrieve a json object mirroring the server configuration where fields are set to true if the corresponding config setting is set through an environment variable. Settings that haven’t been set through environment variables will be missing from the object. Minimum server version: 4.10 ##### Permissions Must have manage_system permission.
get_image_by_url
Fetches an image via Mattermost image proxy. Minimum server version: 3.10 ##### Permissions Must be logged in.
get_logs
Get a page of server logs, selected with page and logs_per_page query parameters. ##### Permissions Must have manage_system permission.
get_notices
Will return appropriate product notices for current user in the team specified by teamId parameter. Minimum server version: 5.26 ##### Permissions Must be logged in.
get_ping
Check if the server is up and healthy based on the configuration setting GoRoutineHealthThreshold. If GoRoutineHealthThreshold and the number of goroutines on the server exceeds that threshold the server is considered unhealthy. If GoRoutineHealthThreshold is not set or the number of goroutines is below the threshold the server is considered healthy. Minimum server version: 3.10 If a "device_id" is passed in the query, it will test the Push Notification Proxy in order to discover whether the device is able to receive notifications. The response will have a "CanReceiveNotifications" property with one of the following values: - true: It can receive notifications - false: It cannot receive notifications - unknown: There has been an unknown error, and it is not certain whether it can receive notifications. Minimum server version: 6.5 ##### Permissions None.
get_prev_trial_license
Get the last trial license used on the sevrer Minimum server version: 5.36 ##### Permissions Must have manage_systems permissions.
get_redirect_location
Minimum server version: 3.10 ##### Permissions Must be logged in.
get_server_busy_expires
Gets the timestamp corresponding to when the server busy flag will be automatically cleared. Minimum server version: 5.20 ##### Permissions Must have manage_system permission.
get_supported_timezone
Minimum server version: 3.10 ##### Permissions Must be logged in.
get_warn_metrics_status
Get the status of a set of metrics (enabled or disabled) from the Systems table. The returned JSON contains the metrics that we need to warn the admin on with regard to their status (we return the ones whose status is "true", which means that they are in a "warnable" state - e.g. a threshold has been crossed or some other condition has been fulfilled). Minimum server version: 5.26 ##### Permissions Must have manage_system permission.
invalidate_caches
Purge all the in-memory caches for the Mattermost server. This can have a temporary negative effect on performance while the caches are re-populated. ##### Permissions Must have manage_system permission.
mark_notices_viewed
Will mark the specified notices as ‘viewed’ by the logged in user. Minimum server version: 5.26 ##### Permissions Must be logged in.
patch_config
Submit configuration to patch. As of server version 4.8, the PluginSettings.EnableUploads setting cannot be modified by this endpoint. ##### Permissions Must have manage_system permission. Minimum server version: 5.20 ##### Note The Plugins are stored as a map, and since a map may recursively go down to any depth, individual fields of a map are not changed. Consider using the update config (PUT api/v4/config) endpoint to update a plugins configurations.
post_log
Add log messages to the server logs. ##### Permissions Users with manage_system permission can log ERROR or DEBUG messages. Logged in users can log ERROR or DEBUG messages when ServiceSettings.EnableDeveloper is true or just DEBUG messages when false. Non-logged in users can log ERROR or DEBUG messages when ServiceSettings.EnableDeveloper is true and cannot log when false.
reload_config
Reload the configuration file to pick up on any changes made to it. ##### Permissions Must have manage_system permission.
remove_license_file
Remove the license file from the server. This will disable all enterprise features. Minimum server version: 4.0 ##### Permissions Must have manage_system permission.
request_license_renewal_link
Request the renewal link that would be used to start the license renewal process Minimum server version: 5.32 ##### Permissions Must have sysconsole_write_about permission.
request_trial_license
Request and install a trial license for your server Minimum server version: 5.25 ##### Permissions Must have manage_system permission.
restart_server
It restarts the current running mattermost instance to execute the new Enterprise binary. Minimum server version: 5.27 ##### Permissions Must have manage_system permission.
send_trial_license_warn_metric_ack
Request a trial license and acknowledge a warning for the warn_metric_id metric crossing a threshold (or some similar condition being fulfilled) - sets the "ack" status for all the warn metrics in the system. Minimum server version: 5.28 ##### Permissions Must have manage_system permission.
send_warn_metric_ack
Acknowledge a warning for the warn_metric_id metric crossing a threshold (or some similar condition being fulfilled) - attempts to send an ack email to acknowledge@mattermost.com and sets the "ack" status for all the warn metrics in the system. Minimum server version: 5.26 ##### Permissions Must have manage_system permission.
set_server_busy
Marks the server as currently having high load which disables non-critical services such as search, statuses and typing notifications. Minimum server version: 5.20 ##### Permissions Must have manage_system permission.
test_email
Send a test email to make sure you have your email settings configured correctly. Optionally provide a configuration in the request body to test. If no valid configuration is present in the request body the current server configuration will be tested. ##### Permissions Must have manage_system permission.
test_s3_connection
Send a test to validate if can connect to AWS S3. Optionally provide a configuration in the request body to test. If no valid configuration is present in the request body the current server configuration will be tested. ##### Permissions Must have manage_system permission. Minimum server version: 4.8
test_site_url
Sends a Ping request to the mattermost server using the specified Site URL. ##### Permissions Must have manage_system permission. Minimum server version: 5.16
update_config
Submit a new configuration for the server to use. As of server version 4.8, the PluginSettings.EnableUploads setting cannot be modified by this endpoint. Note that the parameters that aren’t set in the configuration that you provide will be reset to default values. Therefore, if you want to change a configuration parameter and leave the other ones unchanged, you need to get the existing configuration first, change the field that you want, then put that new configuration. ##### Permissions Must have manage_system permission.
update_marketplace_visited_by_admin
Stores the system-level status that specifies that at least an admin has visited the in-product Plugin Marketplace. Minimum server version: 5.33 ##### Permissions Must have manage_system permissions.
upgrade_to_enterprise
It downloads the Mattermost Enterprise Edition of your current version and replace your current version with it. After the upgrade you need to restart the Mattermost server. Minimum server version: 5.27 ##### Permissions Must have manage_system permission.
upgrade_to_enterprise_status
It returns the percentage of completion of the current upgrade or the error if there is any. Minimum server version: 5.27 ##### Permissions Must have manage_system permission.
upload_license_file
Upload a license to enable enterprise features. Minimum server version: 4.0 ##### Permissions Must have manage_system permission.