This is the documentation page for an unsupported version of Zabbix.
Is this not what you were looking for? Switch to the current version or choose one from the drop-down menu.

mediatype.update

Description

object mediatype.update(object/array mediaTypes)

This method allows to update existing media types.

This method is only available to Super admin user type. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) Media type properties to be updated.

The mediatypeid property must be defined for each media type, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.

Additionally to the standard media type properties, the method accepts the following parameters.

Parameter Type Description
parameters array Webhook parameters to replace the current webhook parameters.
message_templates array Message templates to replace the current message templates.

Return values

(object) Returns an object containing the IDs of the updated media types under the mediatypeids property.

Examples

Enabling a media type

Enable a media type, that is, set its status to "0".

Request:

{
           "jsonrpc": "2.0",
           "method": "mediatype.update",
           "params": {
               "mediatypeid": "6",
               "status": "0"
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "mediatypeids": [
                   "6"
               ]
           },
           "id": 1
       }

Source

CMediaType::update() in ui/include/classes/api/services/CMediaType.php.