object template.massremove(object parameters)
This method allows to remove related objects from multiple templates.
This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.
(object)
Parameters containing the IDs of the templates to update and the objects that should be removed.
Parameter | Type | Description |
---|---|---|
templateids (required) |
string/array | IDs of the templates to be updated. |
groupids | string/array | Host groups to remove the given templates from. |
macros | string/array | User macros to delete from the given templates. |
templateids_clear | string/array | Templates to unlink and clear from the given templates (upstream). |
templateids_link | string/array | Templates to unlink from the given templates (upstream). |
(object)
Returns an object containing the IDs of the updated templates under the templateids
property.
Remove two templates from group "2".
Request:
{
"jsonrpc": "2.0",
"method": "template.massremove",
"params": {
"templateids": [
"10085",
"10086"
],
"groupids": "2"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
Response:
Unlink templates "10106" and "10104" from template "10085".
{
"jsonrpc": "2.0",
"method": "template.massremove",
"params": {
"templateids": "10085",
"templateids_link": [
"10106",
"10104"
]
},
"id": 1
}
Response:
CTemplate::massRemove() in ui/include/classes/api/services/CTemplate.php.