Skip to main content

PATCH Atualizar Doutor

Atualiza os dados de um médico existente. Todos os campos do body são opcionais.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

ID do doutor

O id pode ser obtido na rota de Listar Doutores, no campo id de cada médico.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/doctors/{id}

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID do médico

Body​

CampoTipoObrigatórioDescrição
namestring❌Nome do médico
procedureIdsnumber[]❌IDs dos procedimentos como números (ex: [1, 2, 3]). ⚠️ Não enviar como string ("1", "2")
scheduleDaysobject[]❌Agenda por dia da semana — um item por dia atendido. Substitui a agenda inteira: dias não enviados deixam de existir
scheduleDays[].dayOfWeekstring (enum)✅DOM, SEG, TER, QUA, QUI, SEX ou SAB (um item por dia; não repetir)
scheduleDays[].startTimestring✅Início do atendimento no dia (HH:mm)
scheduleDays[].endTimestring✅Fim do atendimento no dia (HH:mm)
scheduleDays[].intervalMinutesnumber✅Duração de cada horário em minutos (inteiro >= 1)
percentagenumber❌Percentual do médico sobre os procedimentos
userIdsnumber[]❌IDs dos usuários vinculados ao médico
userIdnumber | null❌ID do usuário principal vinculado
isActiveboolean❌Status ativo/inativo. ⚠️ Deve ser true ou false (boolean), não string

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/doctors/31' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"name": "João da Silva",
"procedureIds": [1, 2, 3],
"scheduleDays": [
{ "dayOfWeek": "SEG", "startTime": "08:00", "endTime": "12:00", "intervalMinutes": 30 },
{ "dayOfWeek": "QUA", "startTime": "13:00", "endTime": "18:00", "intervalMinutes": 20 }
],
"isActive": true
}'

Respostas​

200 Atualizado com sucesso​

{
"data": {
"id": 5,
"name": "Dr. João da Silva",
"isActive": true,
"accountId": 1,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.202Z",
"deletedAt": null,
"isBusy": false,
"percentage": 0,
"userId": null,
"scheduleDays": [
{
"id": 115,
"doctorId": 5,
"accountId": 1,
"dayOfWeek": "TER",
"startTime": "09:00",
"endTime": "11:00",
"intervalMinutes": 15,
"isActive": true,
"createdAt": "2026-09-29T22:33:46.202Z",
"updatedAt": "2026-09-29T22:33:46.202Z",
"deletedAt": null
}
],
"doctorProcedures": [
{
"doctorId": 5,
"procedureId": 24,
"createdAt": "2026-09-29T22:33:46.062Z",
"updatedAt": "2026-09-29T22:33:46.062Z",
"deletedAt": null,
"procedure": {
"id": 24,
"name": "ECOCARDIOGRAMA",
"synonyms": "ecocardiografia, ultrassonografia cardíaca, ultrassom do coração, ecografia cardíaca, exame de ecocardiograma, cardiografia por ultrassom, ecografia do coração, ecografia Doppler, ecocardiograma colorido, eco cardíaco.",
"price": "190",
"accountId": 1,
"createdAt": "2026-09-17T16:28:53.375Z",
"updatedAt": "2026-09-17T16:28:55.379Z",
"deletedAt": null,
"laudoLocal": false,
"typeId": 3,
"referralId": null
}
}
],
"users": [],
"user": null
}
}

400 Médico possui agendamentos vinculados​

Retornado quando a atualização tenta remover procedimentos que possuem agendamentos em aberto. Os demais dados enviados são gravados mesmo assim — só a remoção dos procedimentos é recusada.

{
"message": "Os dados do médico foram atualizados, mas não é permitido remover procedimentos que possuem agendamentos em aberto.",
"error": "Bad Request",
"statusCode": 400
}