Skip to main content

PATCH Reagendar Agendamento

Altera a data, o horário e/ou o médico de 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}/reschedule

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID do agendamento

Corpo da Requisição​

CampoTipoObrigatórioDescrição
doctorIdnumber✅ID do médico
datestring✅Nova data no formato YYYY-MM-DD
startTimestring✅Novo horário de início no formato HH:mm
endTimestring✅Novo horário de término no formato HH:mm

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/appointments/5285/reschedule' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"doctorId": 23,
"date": "2026-05-20",
"startTime": "08:00",
"endTime": "08:15"
}'

Respostas​

200 Sucesso​

{
"data": {
"id": 5285,
"date": "2026-05-20T00:00:00.000Z",
"startTime": "08:00",
"endTime": "08:15",
"notes": "Observações sobre o agendamento",
"accountId": 1,
"isFit": false,
"createdAt": "2026-05-18T13:43:13.337Z",
"updatedAt": "2026-05-18T14:03:59.965Z",
"deletedAt": null,
"doctor": {
"id": 23,
"name": "Dr. Joedson"
},
"patient": {
"id": 17540,
"name": "Joao Silva",
"contact": {
"phone": "81999999999"
}
},
"status": {
"id": 1,
"name": "Agendado",
"color": "#ffc107"
},
"appointmentProcedures": {
"procedure": {
"id": 1,
"name": "17 BETA ESTRADIOL E2 - PRIMEIRA AMOSTRA",
"price": "252"
}
}
}
}

400 Bad Request​

Retornado quando a data informada é anterior à data atual.

{
"message": [
"A data deve ser hoje ou uma data futura"
],
"error": "Bad Request",
"statusCode": 400
}

Retornado quando o médico não trabalha no dia informado.

{
"message": "Médico não trabalha neste dia",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando o horário de início ou fim não é permitido para o médico.

{
"message": "Horário de início ou fim não permitido",
"error": "Bad Request",
"statusCode": 400
}

Retornado quando o período cai em um bloqueio da agenda do médico.

{
"message": "Agenda do médico bloqueada neste período (Férias)",
"error": "Bad Request",
"statusCode": 400
}

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, está inativo ou pertence a outra conta (o serviço não trata esse caso explicitamente).