Skip to main content

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​

CampoTipoObrigatórioDescrição
idnumber✅ID do agendamento

Corpo da Requisição​

CampoTipoObrigatórioDescrição
doctorIdnumber✅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
}