Skip to main content

PATCH Atualizar Status do Agendamento

Atualiza o status de um agendamento. Cada status atual permite apenas certas transições.

Autenticação necessária

Esta rota requer o header Authorization: Bearer {accessToken}

ID do agendamento

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}/status

Parâmetros​

CampoTipoObrigatórioDescrição
idnumber✅ID do agendamento (path)
actionstring✅Ação a ser executada. Valores possíveis: Agendado, Confirmado, Na fila, Em atendimento, Cancelado, Finalizado, Faltou
doctorIdnumber❌ID do médico

Requisição​

curl -X 'PATCH' \
  'https://api-dev.imagemais.com.br/api/appointments/5285/status' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {accessToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "action": "Confirmado"
}'

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,
  "isFit": false,
  "createdAt": "2026-05-18T13:43:13.337Z",
  "updatedAt": "2026-05-18T14:23:22.216Z",
  "deletedAt": null,
  "doctorId": 23,
  "doctor": {
    "id": 23,
    "name": "Dr. Joedson"
  },
  "patient": {
    "id": 17541,
    "name": "Joao Silva",
    "dateBirth": "1990-01-01T00:00:00.000Z",
    "contact": {
      "phone": "81999999999"
    }
  },
  "status": {
    "id": 2,
    "name": "Confirmado",
    "color": "#6c757d"
  },
  "appointmentProcedures": {
    "procedure": {
      "id": 1,
      "name": "17 BETA ESTRADIOL E2 - PRIMEIRA AMOSTRA",
      "price": "252",
      "type": null
    }
  }
}

400 Bad Request​

Retornado quando o valor de action não é um dos valores permitidos.

{
  "message": [
    "action must be one of the following values: Agendado, Confirmado, Na fila, Em atendimento, Cancelado, Finalizado, Faltou"
  ],
  "error": "Bad Request",
  "statusCode": 400
}

404 Não Encontrado​

Retornado quando o agendamento informado não existe.

{
  "message": "Agendamento não encontrado"
}