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.

ParameterTypeDescription
parametersarrayWebhook parameters to replace the current webhook parameters.
message_templatesarrayMessage 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:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "mediatype.update",
  4. "params": {
  5. "mediatypeid": "6",
  6. "status": "0"
  7. },
  8. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  9. "id": 1
  10. }

Response:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "mediatypeids": [
  5. "6"
  6. ]
  7. },
  8. "id": 1
  9. }

Source

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