Skip to main content

PATCH Atribuir Usuário à Consulta

Atribui um usuário responsável a uma consulta existente.

Só com token de usuário

Envie o header Authorization: Bearer {accessToken} de um usuário. Esta rota não funciona com x-api-key: a checagem interna usa as permissões do usuário do token e sempre falha com API Key.

Permissão necessária

Exige as permissões create_consultations e update_consultations. Tanto com token JWT quanto com API Key, todas são obrigatórias.

Um usuário só pode ter uma consulta aberta por vez

Se o usuário informado em userId já estiver atribuído a outra consulta com status OPENED, a requisição retorna 409 Conflict. Se o userId já for o responsável atual, a consulta é devolvida sem nenhuma validação.


Endpoint​

PATCH https://api-dev.imagemais.com.br/api/consultations/{id}/assign

Parâmetros​

Path​

CampoTipoObrigatórioDescrição
idnumber✅ID da consulta

Corpo da Requisição (application/json)​

CampoTipoObrigatórioDescrição
userIdnumber✅ID do usuário a ser atribuído à consulta

Requisição​

curl -X 'PATCH' \
'https://api-dev.imagemais.com.br/api/consultations/1/assign' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-H 'Content-Type: application/json' \
-d '{
"userId": 5
}'

Respostas​

200 Sucesso​

Retorna o objeto completo da consulta com o usuário atribuído em assignedUser.

{
"id": 1,
"patientId": 1,
"preConsultationId": 1,
"mainComplaint": "Dor de cabeça há 3 dias",
"currentDiseaseHistory": "Paciente relata cefaleia intensa desde segunda-feira",
"personalHistory": "Hipertensão controlada",
"physicalExam": "PA 120/80, FC 72bpm, bom estado geral",
"medicalConduct": "Repouso e hidratação oral",
"cardiovascularDiseases": "Hipertensão arterial",
"otherRelevantDiseases": "Nenhuma",
"previousSurgeries": "Apendicectomia em 2015",
"familyHistory": "Histórico de AVC na família",
"medicationsUse": "Losartana 50mg 1x/dia",
"allergies": "Nenhuma conhecida",
"lifestyleHabits": "Sedentário, dieta desbalanceada",
"primaryAndSecondaryDiagnosis": "G43.9 - Enxaqueca não especificada",
"diagnosisReasoning": null,
"prescribedMedications": "Paracetamol 750mg a cada 8h, por 3 dias",
"lifestyleAdvice": "Aumento da ingestão de água e redução do estresse",
"followUpExams": "Tomografia de crânio se persistência dos sintomas",
"referralsToSpecialists": "Neurologista",
"medicalCertificate": null,
"declaration": null,
"iaConclusion": "Cefaleia primária sem sinais de alerta",
"urgencyLevel": null,
"specialControlPrescription": null,
"consultationTypeId": null,
"consultationStatusId": 2,
"assignedUserId": 5,
"finalizedByUserId": null,
"finalizedAt": null,
"telemedicineTranscription": null,
"openaiThreadId": null,
"createdAt": "2025-03-07T13:30:34.258Z",
"updatedAt": "2026-05-19T11:19:29.740Z",
"deletedAt": null,
"preConsultation": {
"id": 1,
"bloodPressure": "120/80",
"heartRate": "72",
"temperature": "36.5",
"weight": "70",
"height": "175",
"consultationReason": "Cefaleia",
"glucose": "98 mg/dL",
"updatedAt": "2026-05-19T10:43:21.171Z",
"deletedAt": null
},
"consultationFiles": [
{
"id": 316,
"url": "https://storagedev.imagemaislaboratorio.com.br/consultation/1/1/raio-x/e060a5eeea4c4c40584e4d82ef731c7a9751b6cc73a0e9f3190c29805ef5ec96",
"fileType": "jpg",
"name": "Raio-X - ACCOUNT_PICTURE.jpg",
"accountId": null,
"createdAt": "2026-05-19T10:57:34.897Z",
"updatedAt": "2026-05-19T10:57:34.897Z",
"deletedAt": null
},
{
"id": 317,
"url": "https://storagedev.imagemaislaboratorio.com.br/consultations/1/prescricoes/c08c441ef33a7d37e5fd698375855458414891025da22e47b864347e0f770f7f",
"fileType": "pdf",
"name": "Prescrições - ImageMais.pdf",
"accountId": null,
"createdAt": "2026-05-19T11:13:35.765Z",
"updatedAt": "2026-05-19T11:13:35.765Z",
"deletedAt": null
}
],
"consultationStatus": {
"name": "CLOSED"
},
"cardiologicalOpinion": null,
"specialControlPrescriptionPdf": null,
"memedPrescriptions": [],
"consultationType": null,
"patient": {
"id": 1,
"name": "João da Silva",
"cpf": "12345678900",
"dateBirth": "1990-05-15T00:00:00.000Z",
"gender": {
"name": "M"
},
"contact": {
"phone": "",
"email": "admimagemais@gmail.com"
}
},
"assignedUser": {
"id": 5,
"name": "Sindy Barros"
},
"finalizedByUser": null
}

409 Usuário já possui consulta aberta​

Retornado quando o usuário informado já está atribuído a outra consulta com status OPENED.

{
"message": "Usuário já possui 1 consulta(s) aberta(s) atribuída(s)",
"error": "Conflict",
"statusCode": 409
}

404 Consulta não encontrada​

Retornado quando o id informado na URL não corresponde a nenhuma consulta existente.

{
"statusCode": 404,
"message": "Consulta não encontrada"
}

404 Usuário não encontrado​

Retornado quando o userId informado no corpo não corresponde a nenhum usuário existente.

{
"statusCode": 404,
"message": "Usuário não encontrado",
"error": "Not Found"
}

403 Sem permissão para atribuir​

Apesar da mensagem, a checagem é feita sobre as permissões do usuário autenticado (as do token), não do usuário informado em userId. Com token JWT ela nunca falha (a rota já exige as duas permissões); com API Key ela sempre falha, porque o payload da API Key não carrega a lista de permissões.

{
"statusCode": 403,
"message": "O usuário não possui permissão para ser atribuído a consultas",
"error": "Forbidden"
}