---
title: Criar Usuários
description: Gerencie usuários da sua organização — criar, listar e configurar papéis.
---

# Criar Usuários

O Argos tem dois papéis de usuário dentro de uma organização:

| Papel | Capacidade |
|-------|-----------|
| **Administrador da conta** | Gerencia a organização inteira: câmeras, usuários, notificações, calibração, gravadores |
| **Usuário** | Somente leitura: visualiza câmeras e alertas da organização |

> Somente **administradores da conta** podem criar e gerenciar usuários.

---

## Criar um usuário

```bash
curl -X POST https://argos.automatizase.com.br/api/v1/usuarios \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "Maria Silva",
    "login": "maria@empresa.com",
    "senha": "senha-segura",
    "papel": "usuario",
    "empresa_id": 7
  }'
```

Campos:

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `nome` | string | Nome completo |
| `login` | string | E-mail de acesso |
| `senha` | string | Senha inicial (o usuário deve trocar no primeiro acesso) |
| `papel` | string | `"admin"` ou `"usuario"` |
| `empresa_id` | int | ID da sua organização |

Resposta: `{ "id": 15, "nome": "Maria Silva", "login": "maria@empresa.com", "papel": "usuario", ... }`

---

## Listar usuários da organização

```bash
curl https://argos.automatizase.com.br/api/v1/usuarios \
  -H "Authorization: Bearer $TOKEN"
```

Retorna todos os usuários da sua organização.

---

## Atualizar usuário

```bash
curl -X PATCH https://argos.automatizase.com.br/api/v1/usuarios/15 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "papel": "admin"
  }'
```

---

## Remover usuário

```bash
curl -X DELETE https://argos.automatizase.com.br/api/v1/usuarios/15 \
  -H "Authorization: Bearer $TOKEN"
```

---

## Próximos passos

- **[Autenticação](/docs/guias/autenticacao)** — como o token e os papéis funcionam.
- **[Referência da API](/docs/referencia/api)** — endpoints `/usuarios` em detalhe.