Skip to main content

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​

CampoTipoObrigatórioDescrição
idnumber✅ID do agendamento

Corpo da Requisição​

CampoTipoObrigatórioDescrição
appointmentProcedureIdnumber✅ID do vínculo agendamento-procedimento (appointmentProcedures.id)
idnumber❌ID do novo procedimento — omita para manter o atual
discountIdnumber❌ID do desconto — omita para remover desconto existente
videoRequestedboolean❌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
}