> 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/create-role.md).

# Create role

Cria um cargo na empresa selecionada.

<mark style="color:orange;">`POST`</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/json/:acc`

### **Headers**

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

### **Path Parameters**

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

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

| Key                                        | Type   | Description                                                                 |
| ------------------------------------------ | ------ | --------------------------------------------------------------------------- |
| **name**<mark style="color:red;">\*</mark> | string | Nome do cargo (obrigatório)                                                 |
| **code**                                   | string | Codigo do cargo, para integrações.                                          |
| **context**                                | object | Informações específicas por país, caso queira informar escolaridade ou CBO. |

**Context**

| Key        | Type   | Description                           |
| ---------- | ------ | ------------------------------------- |
| **brazil** | object | Informações específicas para o Brasil |

**Brazil**

| Key                    | Type            | Description                                |
| ---------------------- | --------------- | ------------------------------------------ |
| **cbo**                | string          | Número do CBO                              |
| **escolaridadeMinima** | string(options) | Escolaridade mínima permitida para o cargo |

**Opções de escolaridade mínima**

{% code overflow="wrap" %}

```json
"analfabeto", "5_ano_fundamental_incompleto", "5_ano_fundamental_completo", "6_9_fundamental_incompleto", "fundamental_completo", "medio_incompleto", "medio_completo", "superior_incompleto", "superior_completo", "pos_graduacao", "especializacao", "mestrado", "doutorado", "phd"
```

{% endcode %}

{% hint style="warning" %}
A única informação obrigatória é o <mark style="color:$success;">nome do cargo</mark>**,** porém caso queira informar a <mark style="color:purple;">**escolaridade**</mark> ou <mark style="color:purple;">**CBO**</mark>, precisa usar o <mark style="color:purple;">**context - brazil.**</mark>
{% endhint %}

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

```json
{
    "name": "Analista Programador Jr"
}
```

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

```json
{
    "code":"an-prog-jr",
    "name": "Analista Programador Jr",
    "context": {
        "brazil": {
            "cbo": "789",
            "escolaridadeMinima": "superior_completo"
        }
    }
}
```

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

{% code title="201 OK" %}

```json
{
    "code": 201,
    "messages": null,
    "result": {
        "uid": "3a46ca19-506f-4e80-a217-891d48a2a0ac"
    },
    "status": "ok"
}
```

{% endcode %}

{% hint style="success" %}
O UID em "result" é o identificador do cargo, para usar em outras api's ou integrações.
{% endhint %}