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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do médico |
Body
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | ❌ | Nome do médico |
procedureIds | number[] | ❌ | IDs dos procedimentos como números (ex: [1, 2, 3]). ⚠️ Não enviar como string ("1", "2") |
scheduleDays | object[] | ❌ | Agenda por dia da semana — um item por dia atendido. Substitui a agenda inteira: dias não enviados deixam de existir |
scheduleDays[].dayOfWeek | string (enum) | ✅ | DOM, SEG, TER, QUA, QUI, SEX ou SAB (um item por dia; não repetir) |
scheduleDays[].startTime | string | ✅ | Início do atendimento no dia (HH:mm) |
scheduleDays[].endTime | string | ✅ | Fim do atendimento no dia (HH:mm) |
scheduleDays[].intervalMinutes | number | ✅ | Duração de cada horário em minutos (inteiro >= 1) |
percentage | number | ❌ | Percentual do médico sobre os procedimentos |
userIds | number[] | ❌ | IDs dos usuários vinculados ao médico |
userId | number | null | ❌ | ID do usuário principal vinculado |
isActive | boolean | ❌ | 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
}