PATCH Atribuir Usuário à Consulta

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

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

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. Também é exigida a permissão update_consultations ou create_consultations para o usuário ser atribuído.

---

Endpoint

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

---

Parâmetros

Path

Campo	Tipo	Obrigatório	Descrição
id	number	✅	ID da consulta

Corpo da Requisição (application/json)

Campo	Tipo	Obrigatório	Descrição
userId	number	✅	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 Usuário-alvo sem permissão

Retornado quando o usuário informado em userId (não o usuário autenticado) não possui a permissão update_consultations nem create_consultations.

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