> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/middleware/assistente-utilitario/api/user.md).

# Usuários

## Adicionar Usuário (Cache Local)

<mark style="color:green;">`POST`</mark> `http://utility-assistant.local/user`

Serviço para cadastro de novos usuários no cache local, ao consumir esse serviço deve ser enviado as credenciais do usuário (username + otp) para autenticação e autorização da aplicação local. (client credentials)&#x20;

#### Headers

| Name         | Type   | Description                       |
| ------------ | ------ | --------------------------------- |
| Content-Type | string | application/x-www-form-urlencoded |
| Accept       | string | application/json                  |

#### Request Body

| Name     | Type   | Description        |
| -------- | ------ | ------------------ |
| username | string | Usuário (CPF/CNPJ) |
| password | string | Código OTP         |

{% tabs %}
{% tab title="201 Cache criado com sucesso" %}

```javascript
{
    "detail": {
		"code": 1128,
		"status": "CACHE_CREATED",
		"message": "Cache created"
	}
}
```

{% endtab %}

{% tab title="400 Falha ao criar cache, credenciais inválidas" %}

```javascript
{
	"detail": {
		"code": 1056,
		"status": "INVALID_CREDENTIALS",
		"message": "Invalid credentials"
	}
}
```

{% endtab %}
{% endtabs %}

## Listar Usuários (Cache Local)

<mark style="color:blue;">`GET`</mark> `http://utility-assistant.local/user`

Serviço para listagem de usuários armazenados no cache local

#### Headers

| Name   | Type   | Description      |
| ------ | ------ | ---------------- |
| Accept | string | application/json |

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

```javascript
{
	"users": [{
		"id": 1,
		"name": "NOME DO USUÁRIO",
		"username": "01234567890",
		"date_last_update": "2019-01-26 10:14:36",
        "photo": "Foto/Thumbnail encodada em base64, veja RFC2397"
    }],
	"detail": {
		"code": 1093,
		"status": "USER_LISTED",
		"message": "User list"
	}
}
```

{% endtab %}
{% endtabs %}

## Remover Usuário (Cache Local)

<mark style="color:red;">`DELETE`</mark> `http://utility-assistant.local/user/:id`

#### Path Parameters

| Name | Type    | Description   |
| ---- | ------- | ------------- |
| id   | integer | ID do usuário |

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

```
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
A remoção do usuário através da API não implica o bloqueio da aplicação (computador/servidor), para bloqueio de pedidos de autenticação, remoção de vinculo com aplicação ou revogação de sessões em aberto, acesse o portal do usuário.
{% endhint %}