[comment]: # translation:outdated

[comment]: # ({7e2bc778-7e2bc778})
# usergroup.delete

[comment]: # ({/7e2bc778-7e2bc778})

[comment]: # ({849042c4-c1ef47a5})
### Beschreibung

`object usergroup.delete(array userGroupIds)`

Mit dieser Methode können Benutzergruppen gelöscht werden.

::: noteimportant
Die Benutzergruppe [Deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration)
(die in [Authentication](/manual/api/reference/authentication/object) für `disabled_usrgrpid` angegebene Benutzergruppe) kann nicht gelöscht werden.
:::

::: noteclassic
Diese Methode ist nur für den Benutzertyp *Super admin* verfügbar.
Die Berechtigung zum Aufrufen der Methode kann in den Einstellungen der Benutzerrolle entzogen werden.
Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/849042c4-c1ef47a5})

[comment]: # ({22b6416d-22b6416d})
### Parameter

`(array)` IDs der zu löschenden Benutzergruppen.

[comment]: # ({/22b6416d-22b6416d})

[comment]: # ({dde57d64-dde57d64})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der gelöschten Benutzergruppen in der Eigenschaft `usrgrpids` enthält.

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

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

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

[comment]: # ({0572824b-156418d8})
#### Mehrere Benutzergruppen löschen

Löschen Sie zwei Benutzergruppen.

[Anfrage](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "usergroup.delete",
    "params": [
        "20",
        "21"
    ],
    "id": 1
}
```

Antwort:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "usrgrpids": [
            "20",
            "21"
        ]
    },
    "id": 1
}
```

[comment]: # ({/0572824b-156418d8})

[comment]: # ({9a88f22f-9a88f22f})
### Quelle

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

[comment]: # ({/9a88f22f-9a88f22f})