POST Abrir Chamado
Abre um chamado de bug. Aceita até 5 anexos (PNG, JPG, GIF ou PDF, 10 MB cada) no campo "files".
Só com token de usuário
Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: com x-api-key a resposta é 403 "Esta rota está disponível apenas para usuários autenticados.".
Permissão necessária
Exige a permissão create_bugs.
Endpoint
POST https://api-dev.imagemais.com.br/api/bugs
Corpo da Requisição (multipart/form-data)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
files | file[] | ❌ | Arquivos anexados (zero ou mais) |
title | string | ✅ | Resumo curto do problema (mín. 5 caracteres; até 120 caracteres) |
description | string | ✅ | Detalhamento do erro e passos para reproduzir (mín. 10 caracteres; até 5000 caracteres) |
severity | string | ❌ | Severidade (LOW, MEDIUM, HIGH) |
Requisição
curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/bugs' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-F 'files=@anexo.pdf' \
-F 'title=Erro ao salvar prescrição na consulta' \
-F 'description=Ao clicar em Salvar a tela fica carregando e volta o erro...' \
-F 'severity=LOW'
Respostas
201 Sucesso
{
"uuid": "ede3346f-5aeb-4a93-8855-5367ea93d826",
"title": "TESTE DOC — chamado de exemplo",
"description": "Texto de exemplo.",
"severity": "LOW",
"status": "PENDING",
"adminComment": null,
"accountId": 1,
"userId": 1,
"resolvedBy": null,
"createdAt": "2026-09-30T18:48:42.123Z",
"updatedAt": "2026-09-30T18:48:42.123Z",
"files": [],
"user": {
"id": 1,
"name": "Nome Exemplo"
}
}
400 Requisição inválida
Retornado quando o corpo ou a query não passam na validação. A lista message traz um item por regra violada, por exemplo:
{
"message": [
"title must be shorter than or equal to 120 characters",
"Escreva um título com pelo menos 5 caracteres.",
"title must be a string"
],
"error": "Bad Request",
"statusCode": 400
}
403 Sem permissão
Mensagens possíveis:
Permissões insuficientesEsta rota está disponível apenas para usuários autenticados.
{
"message": "Permissões insuficientes",
"error": "Forbidden",
"statusCode": 403
}