PATCH Atualizar Procedimento do Agendamento
Atualiza o procedimento e/ou desconto vinculado a um agendamento.
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 (path) pode ser obtido na rota de Listar Agendamentos, no campo data[].id de cada agendamento.
appointmentProcedureId
Apenas appointmentProcedureId é obrigatório. Os outros dois campos são totalmente opcionais e independentes entre si.
Endpoint
PATCH https://api-dev.imagemais.com.br/api/appointments/{id}/procedures
Path Parameter
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID do agendamento |
Corpo da Requisição
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
appointmentProcedureId | number | ✅ | ID do vínculo agendamento-procedimento (appointmentProcedures.id) |
id | number | ❌ | ID do novo procedimento — omita para manter o atual |
discountId | number | ❌ | ID do desconto — omita para remover desconto existente |
videoRequested | boolean | ❌ | Grava o vídeo do exame (Baby Video). Só para procedimento de imagem, com a integração ligada. Procedimento da lista de vídeo automático já nasce marcado e não aceita false |
Requisição
curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/appointments/5285/procedures' \
-H 'accept: */*' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"appointmentProcedureId": 5283,
"id": 3644,
"discountId": 4
}'
Respostas
200 Sucesso
{
"id": 5283,
"appointmentId": 5285,
"procedureId": 3644,
"price": "140",
"createdAt": "2026-05-18T13:43:13.337Z",
"updatedAt": "2026-05-18T14:53:18.288Z"
}
400 Bad Request
Retornado quando appointmentProcedureId não é enviado.
{
"message": [
"appointmentProcedureId must be an integer number",
"appointmentProcedureId must be a positive number",
"appointmentProcedureId must be a number conforming to the specified constraints"
],
"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
}
Retornado quando o procedimento informado não está vinculado ao médico do agendamento.
{
"message": "Médico não encontrado para o procedimento",
"error": "Not Found",
"statusCode": 404
}
500 Erro Interno
Retornado quando o appointmentProcedureId é inválido ou não existe.
{
"message": "Erro ao atualizar procedimentos do agendamento",
"error": "Internal Server Error",
"statusCode": 500
}