PATCH Trocar Médico do Agendamento
Troca o médico responsável por um agendamento existente.
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 agendamento
O id pode ser obtido na rota de Listar Agendamentos, no campo data[].id de cada agendamento.
Endpoint
PATCH https://api-dev.imagemais.com.br/api/appointments/{id}/change-doctor
Path Parameter
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do agendamento |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
doctorId | number | ✅ | ID do novo médico (inteiro positivo) |
Agendamento em atendimento
Se o agendamento estiver Em atendimento, o médico anterior é marcado como livre e o novo como ocupado (isBusy), com eventos em tempo real para a recepção.
Requisição
curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/appointments/5285/change-doctor' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"doctorId": 2
}'
Respostas
200 Sucesso
{
"id": 73,
"date": "2026-09-18T00:00:00.000Z",
"startTime": "09:00",
"endTime": "09:30",
"notes": "",
"doctorId": 4,
"accountId": 1,
"createdByUserId": 1,
"createdAt": "2026-09-17T11:03:17.526Z",
"updatedAt": "2026-09-17T11:03:35.712Z",
"patient": {
"id": 53,
"name": "Maria Oliveira Santos",
"cpf": "12345678900",
"dateBirth": "1948-08-04T00:00:00.000Z",
"gender": {
"name": "M"
},
"contact": {
"phone": "(81) 99999-9999"
},
"address": {
"cep": "54510360"
}
},
"doctor": {
"name": "Dr. Victor Rocha ",
"doctorProcedures": [
{
"procedure": {
"id": 21,
"name": "Ultrassom: Doppler Obstetrico 2/3 Trimestre",
"price": "100",
"discounts": []
}
},
{
"procedure": {
"id": 22,
"name": "ULTRASSOM: ABDOME TOTAL",
"price": "100",
"discounts": []
}
}
],
"intervalMinutes": 30
},
"createdBy": {
"id": 1,
"name": "Ana Ferreira Souza"
},
"priorityAppointment": {
"id": 2,
"name": "Idoso"
},
"budget": {
"id": 106,
"budgetsProcedures": [
{
"id": 165,
"price": "132",
"procedure": {
"id": 14,
"name": "HISTONA - ANTICORPOS",
"price": "132",
"discounts": []
},
"discountBudgetsProcedures": null
}
],
"movements": [
{
"createdAt": "2026-09-17T11:03:29.562Z",
"value": "132",
"status": {
"name": "PAID"
},
"paymentMethod": {
"name": "PIX_PAGAMENTO_INSTANTANEO"
},
"movementsOptions": null
}
]
},
"appointmentProcedures": {
"id": 73,
"price": "132",
"discountsAppointmentProcedures": null,
"procedure": {
"id": 14,
"name": "HISTONA - ANTICORPOS",
"price": "132",
"laudoLocal": false,
"referral": null
}
},
"status": {
"name": "Finalizado",
"color": "#6B7280"
},
"movements": []
}
404 Não Encontrado
Retornado quando o agendamento não existe na conta.
{
"message": "Agendamento não encontrado",
"error": "Not Found",
"statusCode": 404
}
500 Erro Interno
Retornado quando o doctorId informado não existe (falha ao gravar a troca).
{
"message": "Erro ao trocar de médico",
"error": "Internal Server Error",
"statusCode": 500
}