PUT
/api/consultation-reports/{id}Editar laudo
Muda o título e o texto do laudo.
- Exige o token de acesso — como obter
- Permissão “Editar laudo de outro médico”
(reports.edit_others)
Headers
| Nome | Tipo | Obrig. | Descrição |
|---|---|---|---|
Authorization | string | Sim | Bearer {access_token}, com o token que o login devolve. |
Content-Type | string | Sim | application/json |
Parâmetros do caminho
| Nome | Tipo | Obrig. | Descrição |
|---|---|---|---|
id | uuid | Sim | O laudo. |
Corpo da requisição
| Nome | Tipo | Obrig. | Descrição |
|---|---|---|---|
title | string | Não | Título novo. |
content | string | Não | Texto novo, em HTML. |
motivo | string | Não | Por que o laudo mudou. Obrigatório na retificação. |
Campos da resposta
| Nome | Tipo | Descrição |
|---|---|---|
id | uuid | O laudo. |
registro | string | null | O número do laudo na clínica: USG, VCP ou ECO, o ano e a sequência (USG2026-0142). |
title | string | Título. |
content | string | O texto do laudo, em HTML. As imagens do exame vêm embutidas (base64) ou por um link que vale até 6 horas. |
report_type | string | O tipo, que sai do exame: ultrassom, videocolposcopia, ecocardiograma... |
retificacao_exige_motivo | boolean | Se mudar o texto pede motivo (ver Editar laudo). |
dicom_study_id | uuid | null | O estudo do aparelho, quando o exame veio dele. |
status | string | Hoje sempre draft: o laudo vale desde que é criado. |
appointment_date | string | A data do exame (ISO 8601). |
procedure_name | string | O procedimento, como o laudo mostra. |
appointment | object | O exame do laudo. |
patient | object | O paciente. |
doctor | object | O médico que assina. |
created_at | string | Quando o laudo foi liberado (ISO 8601). |
updated_at | string | A última alteração (ISO 8601). |
signature_frozen_at | string | null | Quando a assinatura deste texto foi fixada. |
signature_frozen_url | string | null | A assinatura que valia quando este texto foi gravado. Para imprimir, prefira esta à doctor.signature_url. O endereço pode expirar: imprima logo depois de pedir o laudo. |
pre_laudo_por | object | null | Quem preparou o texto que o médico assinou ({ id, name }), quando houve pré-laudo. |
Request URL
https://api-endosystem.imagemais.com.br/api/consultation-reports/c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5bcurl -X PUT "https://api-endosystem.imagemais.com.br/api/consultation-reports/c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5b" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content":"<p><strong>ULTRASSONOGRAFIA OBSTÉTRICA</strong></p><p>Gestação única, tópica, com feto vivo.</p><p><strong>IMPRESSÃO DIAGNÓSTICA:</strong></p><p>Gestação de 30 semanas e 6 dias.</p>","motivo":"Correção da idade gestacional."}'{
"content": "<p><strong>ULTRASSONOGRAFIA OBSTÉTRICA</strong></p><p>Gestação única, tópica, com feto vivo.</p><p><strong>IMPRESSÃO DIAGNÓSTICA:</strong></p><p>Gestação de 30 semanas e 6 dias.</p>",
"motivo": "Correção da idade gestacional."
...{
"content": "<p><strong>ULTRASSONOGRAFIA OBSTÉTRICA</strong></p><p>Gestação única, tópica, com feto vivo.</p><p><strong>IMPRESSÃO DIAGNÓSTICA:</strong></p><p>Gestação de 30 semanas e 6 dias.</p>",
"motivo": "Correção da idade gestacional."
}Respostas
{
"id": "c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5b",
"registro": "USG2026-0142",
...{
"id": "c8e0a2b4-6d8f-4a1c-9e3b-5d7f9a1c3e5b",
"registro": "USG2026-0142",
"title": "Ultrassonografia Obstétrica",
"content": "<p><strong>ULTRASSONOGRAFIA OBSTÉTRICA</strong></p><p>Gestação única, tópica, com feto vivo.</p><p><strong>IMPRESSÃO DIAGNÓSTICA:</strong></p><p>Gestação de 30 semanas e 6 dias.</p>",
"report_type": "ultrassom",
"retificacao_exige_motivo": true,
"dicom_study_id": null,
"status": "draft",
"appointment_date": "2026-10-20T09:30:00-03:00",
"procedure_name": "US OBSTÉTRICO",
"appointment": {
"id": "b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f",
"appointment_date": "2026-10-20T09:30:00-03:00",
"procedure_name": "US OBSTÉTRICO",
"status": "completed"
},
"patient": {
"id": "9d3f1c2a-6b7e-4a8d-9f01-23456789abcd",
"name": "MARIA DA SILVA",
"birth_date": "1990-03-15",
"phone": "(81) 99999-0000",
"cpf": "12345678909"
},
"doctor": {
"id": "5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01",
"name": "Dra. Ana Souza",
"role": "medico",
"crm": "12345-PE",
"specialty": "Radiologia e Diagnóstico por Imagem",
"signature_url": "https://storage.exemplo.com/doctors/signatures/9f2c41ab/4e8d0c7b1a2f4c6e8a0b2d4f6a8c0e1b.png"
},
"created_at": "2026-10-20T10:12:40-03:00",
"updated_at": "2026-10-21T08:05:13-03:00",
"signature_frozen_at": "2026-10-20T10:12:40-03:00",
"signature_frozen_url": "https://storage.exemplo.com/doctors/signatures/9f2c41ab/4e8d0c7b1a2f4c6e8a0b2d4f6a8c0e1b.png",
"pre_laudo_por": null
}{
"error": "Informe o motivo da retificação.",
"code": "motivo_obrigatorio"
...{
"error": "Informe o motivo da retificação.",
"code": "motivo_obrigatorio"
}{
"error": "ID inválido"
}{
"error": "ID inválido"
}{
"error": "Laudo não encontrado"
}{
"error": "Laudo não encontrado"
}{
"error": "Este laudo é de outro médico. Só ele ou um administrador pode editá-lo."
}{
"error": "Este laudo é de outro médico. Só ele ou um administrador pode editá-lo."
}{
"error": "Token ausente",
"message": "Token de autenticação necessário.",
...{
"error": "Token ausente",
"message": "Token de autenticação necessário.",
"code": "TOKEN_MISSING"
}{
"error": "Token expirado",
"message": "Sua sessão expirou. Faça login novamente.",
...{
"error": "Token expirado",
"message": "Sua sessão expirou. Faça login novamente.",
"code": "TOKEN_EXPIRED"
}{
"error": "Token inválido",
"message": "Token de autenticação inválido. Faça login novamente.",
...{
"error": "Token inválido",
"message": "Token de autenticação inválido. Faça login novamente.",
"code": "TOKEN_INVALID"
}{
"error": "Acesso revogado",
"message": "Seu acesso foi desativado. Procure o administrador da clínica.",
...{
"error": "Acesso revogado",
"message": "Seu acesso foi desativado. Procure o administrador da clínica.",
"code": "ACCESS_REVOKED"
}{
"error": "Erro interno do servidor"
}{
"error": "Erro interno do servidor"
}