[comment]: # ({6a96957a-6a96957a})
# hostgroup.delete

[comment]: # ({/6a96957a-6a96957a})

[comment]: # ({e6ed19fd-e6ed19fd})
### Description

`object hostgroup.delete(array hostGroupIds)`

This method allows to delete host groups.

A host group can not be deleted if:

-   it contains hosts that belong to this group only;
-   it is marked as internal;
-   it is used by a host prototype;
-   it is used in a global script;
-   it is used in a correlation condition.

[comment]: # ({/e6ed19fd-e6ed19fd})

[comment]: # ({af1f0187-af1f0187})
### Parameters

`(array)` IDs of the host groups to delete.

[comment]: # ({/af1f0187-af1f0187})

[comment]: # ({288daefc-288daefc})
### Return values

`(object)` Returns an object containing the IDs of the deleted host
groups under the `groupids` property.

[comment]: # ({/288daefc-288daefc})

[comment]: # ({b41637d2-b41637d2})
### Examples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({a6d8d11e-a6d8d11e})
#### Deleting multiple host groups

Delete two host groups.

Request:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "hostgroup.delete",
    "params": [
        "107824",
        "107825"
    ],
    "auth": "3a57200802b24cda67c4e4010b50c065",
    "id": 1
}
```

Response:

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107824",
            "107825"
        ]
    },
    "id": 1
}
```

[comment]: # ({/a6d8d11e-a6d8d11e})

[comment]: # ({f496d50e-f496d50e})
### Source

CHostGroup::delete() in
*ui/include/classes/api/services/CHostGroup.php*.

[comment]: # ({/f496d50e-f496d50e})