PATCH Atualizar Agendamento
Atualiza os dados de um agendamento existente.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
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}
Path Parameter
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do agendamento |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
patient.name | string | ✅ | Nome do paciente — obrigatório na prática, mesmo com patient.id (sem ele a atualização do paciente falha com 500) |
patient.dateBirth | string | ❌ | Data de nascimento no formato YYYY-MM-DD |
patient.cpf | string | ❌ | CPF do paciente (somente números) |
patient.gender.name | string | ❌ | Gênero. Exemplo: M, F |
patient.id | number | ❌ | ID do paciente. Com id, o paciente é atualizado; sem id, um novo paciente é criado e vinculado ao agendamento |
patient.contact.phone | string | ❌ | Telefone de contato |
notes | string | ❌ | Observações do agendamento |
priority | string | ❌ | Prioridade: Gestante, Idoso, PcD ou Criança. Se omitido, a prioridade atual é removida |
isFit | boolean | ❌ | Indica se o agendamento é um encaixe (definido pelo usuário) |
videoRequested | boolean | ❌ | Grava o vídeo do exame (Baby Video). Só muda até o atendimento; marcar exige procedimento de imagem e a integração Baby Video ligada; procedimento da lista de vídeo automático não pode ser desmarcado |
Apesar de todos os campos serem opcionais na validação, o serviço lê patient.id — sem o objeto patient a requisição falha com 500. Data, horário, médico e procedimentos não são alterados por esta rota: use Reagendar, Trocar Médico ou Atualizar Procedimento do Agendamento.
Requisição
curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/appointments/5285' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"patient": {
"name": "João Silva",
"dateBirth": "1990-01-01",
"cpf": "99753917023",
"gender": { "name": "M" },
"contact": { "phone": "81999999999" }
},
"notes": "Observações sobre o agendamento",
"priority": "PcD"
}'
Respostas
200 Sucesso
{
"id": 5285,
"date": "2026-05-20T00:00:00.000Z",
"startTime": "08:00",
"endTime": "08:15",
"notes": "Observações sobre o agendamento",
"accountId": 1,
"createdAt": "2026-05-18T13:43:13.337Z",
"updatedAt": "2026-05-18T14:14:36.758Z",
"deletedAt": null,
"doctor": {
"id": 23,
"name": "Dr. Joedson"
},
"patient": {
"dateBirth": "1990-01-01T00:00:00.000Z",
"id": 17541,
"name": "Joao Silva",
"cpf": "99753917023",
"contact": {
"phone": "81999999999"
}
},
"status": {
"id": 1,
"name": "Agendado",
"color": "#ffc107"
},
"appointmentProcedures": {
"price": "252",
"discountsAppointmentProcedures": null,
"procedure": {
"id": 1,
"name": "17 BETA ESTRADIOL E2 - PRIMEIRA AMOSTRA",
"price": "252"
}
}
}
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 corpo não traz patient ("Erro ao atualizar agendamento") ou quando patient.id é enviado sem patient.name ("Erro ao atualizar paciente") — a atualização do paciente exige o nome.
{
"message": "Erro ao atualizar agendamento",
"error": "Internal Server Error",
"statusCode": 500
}
409 Conflito
Retornado quando já existe um paciente cadastrado com o CPF informado.
{
"message": "Já existe um paciente com esse CPF",
"error": "Conflict",
"statusCode": 409
}