Criar Departamento

Cria novo departamento vinculado à empresa. Requer scope departamentos:write.

Autenticação:

🔑 API Key

Corpo

empresa_idnumber

Obrigatório

ID da empresa (matriz ou filial)

nome_departamentostring

Obrigatório

Nome do departamento

localstring

Localização do departamento

Respostas

{
  "ok": true,
  "data": {
    "departamento_id": 15,
    "empresa_id": 1,
    "nome_departamento": "Recursos Humanos",
    "local": "Sala 302",
    "created_at": "2026-02-04T15:30:00Z"
  }
}

Sandbox Mode

curl --request POST \
  'http://localhost:3000/api/v1/departamentos' \
  --header 'x-api-key: yk_sua_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "empresa_id": 1,
  "nome_departamento": "Recursos Humanos",
  "local": "Sala 302"
}'

Exemplos de Resposta

{
  "ok": true,
  "data": {
    "departamento_id": 15,
    "empresa_id": 1,
    "nome_departamento": "Recursos Humanos",
    "local": "Sala 302",
    "created_at": "2026-02-04T15:30:00Z"
  }
}