# Delete roles

**DELETE /_security/role/{name}**

Delete roles in the native realm.
The role management APIs are generally the preferred way to manage roles, rather than using file-based role management.
The delete roles API cannot remove roles that are defined in roles files.

## Required authorization

* Cluster privileges: `manage_security`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **name** (string)
  The name of the role.

### Query parameters
- **refresh** (string)
  If `true` (the default) then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.


## Responses
### 200


#### Body: application/json (object)
- **found** (boolean)
  If the role is successfully deleted, `found` is `true`.
  Otherwise, `found` is `false`.


[Powered by Bump.sh](https://bump.sh)