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
       }
Copy
✔ Copied

Response:

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

Source

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

To toggle search highlight, press Ctrl+Alt+H
Have an improvement suggestion for this page? Select the text that could be improved and press Ctrl+Enter to send it to the editors.