> For the complete documentation index, see [llms.txt](https://devcenter.unico.io/unico-people/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://devcenter.unico.io/unico-people/unico-people-v1/apis/cargos/delete-role.md).

# Delete role

Deleta um cargo da empresa selecionada.

<mark style="color:red;">`DELETE`</mark> \ <mark style="color:$primary;">**Url Produção:**</mark> `https://api.acessorh.com.br`\ <mark style="color:$primary;">**Url Homologação:**</mark> `https://api.rh.homolog.acesso.io`\ <mark style="color:$primary;">**Endpoint:**</mark> `/v1/role`

### **Headers**

| Key                                             | Type   | Description                                                    |
| ----------------------------------------------- | ------ | -------------------------------------------------------------- |
| Authorization<mark style="color:red;">\*</mark> | string | Token de acesso adquirido pela plataforma Identity *(bearer)*. |

### **Query Parameters**

| Key                                   | Type   | Description                                                                                        |
| ------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| uid<mark style="color:red;">\*</mark> | string | UID do cargo a ser deletado, consulte aqui.                                                        |
| acc<mark style="color:red;">\*</mark> | string | UID da [empresa](/unico-people/unico-people-v1/apis/organizacao.md) de onde o cargo será deletado. |

### Exemplo de requisição <a href="#exemplo-de-requisicao" id="exemplo-de-requisicao"></a>

```json
curl --location --request DELETE 'https://api.acessorh.com.br/v1/role?acc=id%20da%20empresa&uid=id%20do%20cargo' \
--header 'Authorization: Bearer token de auth'
```

### Exemplo de response <a href="#exemplo-de-requisicao" id="exemplo-de-requisicao"></a>

```json
200 - OK
```