> 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/posicoes/set-benefits-in-a-position.md).

# Set benefits in a position

Adiciona e/ou remove benefícios de uma posição.

<mark style="color:purple;">`PATCH`</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/positions/:position/benefits`

### **Headers**

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

### **Path Parameters**

| Key                                        | Type   | Description                                                                |
| ------------------------------------------ | ------ | -------------------------------------------------------------------------- |
| position<mark style="color:red;">\*</mark> | string | UID ou número da posição a ser alterada. [Consulte aqui](#list-positions). |

### Descrição do body JSON da request <a href="#descricao-do-body-json-da-request-2" id="descricao-do-body-json-da-request-2"></a>

| Key                                        | Type           | Description                                                                                                                                                                 |
| ------------------------------------------ | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **unit**<mark style="color:red;">\*</mark> | string         | UID da filial onde a posição se encontra                                                                                                                                    |
| **add**                                    | array\[string] | UIDs dos grupos de benefícios a serem adicionadas na posição. [Consulte aqui](/unico-people/unico-people-v1/apis/beneficios.md#list-benefits-groups).                       |
| **remove**                                 | array\[string] | <p>UIDs dos grupos de benefícios a serem</p><p>removidos da posição. <a href="/unico-people/unico-people-v1/apis/beneficios.md#list-benefits-groups">Consulte aqui</a>.</p> |

{% hint style="info" %}

* Um dos campos <mark style="color:$warning;">`add`</mark> ou <mark style="color:$warning;">`remove`</mark> deverão ser preenchidos.
* <mark style="color:$danger;">**Importante**</mark>: Não é possível adicionar ou remover benefícios para posições *declinadas* ou *arquivadas.*
  {% endhint %}

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

```json
{
    "unit": "4bdaa0d3-f3e4-4520-b64e-6a22508bebc9",
    "add": ["c4c17fd1-9c93-4dbf-bca8-bded7fd97287"],
    "remove": ["87a6e88f-c318-416b-830e-8cf446f535fe"]
}
```

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

{% code title="200 OK" %}

```json
"ok"
```

{% endcode %}