# Departamentos

O departamento a ser selecionado na criação de vaga do candidato. Código é um campo aberto e opcional para uso de outros sistemas em caso de integração, sendo assim não existe validações neste campo.

## Create department

<mark style="color:green;">`POST`</mark> `https://api.acessorh.com.br/v1/department/json/:acc`

Cria um departamento na empresa selecionada.

#### Path Parameters

| Name | Type   | Description                             |
| ---- | ------ | --------------------------------------- |
| acc  | string | UID da empresa onde o cargo será criado |

#### Headers

| Name          | Type   | Description                                                   |
| ------------- | ------ | ------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma Identity (*bearer*) |

{% tabs %}
{% tab title="201 " %}

```
```

{% endtab %}
{% endtabs %}

* [Descrição do body JSON da requisição](/project/api/departamentos.md#descricao-do-body-json-da-requisicao)
* [Exemplo de requisição](/project/api/departamentos.md#exemplo-de-requisicao)

### Descrição do body JSON da requisição

| Chave                                                | Tipo   | Descrição              |
| ---------------------------------------------------- | ------ | ---------------------- |
| <p><strong>code</strong></p><p><em>required</em></p> | string | Código do departamento |
| <p><strong>name</strong></p><p><em>required</em></p> | string | Nome do departamento   |

### Exemplo de requisição

```javascript
{
	"code": "ti",
    "name": "Tecnologia da Informação"
}
```

## List departments

<mark style="color:blue;">`GET`</mark> `https://api.acessorh.com.br/v1/department/:acc`

Lista os departamentos da empresa selecionada.

#### Path Parameters

| Name | Type   | Description                                            |
| ---- | ------ | ------------------------------------------------------ |
| acc  | string | UID da empresa de onde os departamentos serão listados |

#### Query Parameters

| Name  | Type   | Description                                                 |
| ----- | ------ | ----------------------------------------------------------- |
| limit | string | Limite de departamentos que serão listados (paginação)      |
| skip  | string | Indica a quantidade de cargos que serão pulados (paginação) |
| code  | string | Código do departamento a ser filtrado                       |

#### Headers

| Name          | Type   | Description                                                      |
| ------------- | ------ | ---------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma de Identity *(bearer)* |

{% tabs %}
{% tab title="200 " %}

```javascript
[
    {
        "acc": "2d9174c4-06b7-4956-a5dc-8824d8a2f49e",
        "code": "financ",
        "id": "2f642a78-8fa7-4a05-8bb3-b6d25ddbd6fa",
        "name": "Financeiro"
    }
]
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
Caso não seja inserido os parâmetros `limit` e `skip` , os valores padrões serão, respectivamente, 1000 e 0.

O parâmetro `limit` tem o seu valor máximo como 1000.
{% endhint %}

## Delete department

<mark style="color:red;">`DELETE`</mark> `https://api.acessorh.com.br/v1/department`

Deleta um departamento da empresa selecionada.

#### Query Parameters

| Name | Type   | Description                                          |
| ---- | ------ | ---------------------------------------------------- |
| uid  | string | UID do departamento a ser deletado.                  |
| acc  | string | UID da empresa de onde o departamento será deletado. |

#### Headers

| Name          | Type   | Description                                                    |
| ------------- | ------ | -------------------------------------------------------------- |
| Authorization | string | Token de acesso adquirido pela plataforma Identity *(bearer)*. |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://acessorh.gitbook.io/project/api/departamentos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.