PUT/api/appointments/{id}

Editar agendamento

Muda só os campos enviados: remarcar, mudar o status, os campos extras ou as observações.

Exige o token de acesso — como obter

Headers

Nome	Tipo	Obrig.	Descrição
`Authorization`	string	Sim	Bearer {access_token}, com o token que o login devolve.
`Content-Type`	string	Sim	application/json

Parâmetros do caminho

Nome	Tipo	Obrig.	Descrição
`id`	uuid	Sim	O agendamento.

Corpo da requisição

Nome	Tipo	Obrig.	Descrição
`appointment_date`	string	Não	Data e hora, ISO 8601 com o fuso.
`status`	string	Não	scheduled, confirmed, in_progress, completed, cancelled ou no_show.
`procedure_fields_data`	object \| null	Não	Os campos extras, inteiros. null apaga.
`notes`	string \| null	Não	Observações.
`procedure_id`	uuid	Não	Outro procedimento, para corrigir um exame feito no procedimento errado.
`motivo`	string	Não	Por que o procedimento foi trocado. Obrigatório quando a troca pede motivo.

Campos da resposta

Nome	Tipo	Descrição
`id`	uuid	O agendamento. É também o id do exame nas rotas de laudo.
`patient_id`	uuid	O paciente.
`patient_name`	string	O nome do paciente na hora do agendamento.
`procedure_id`	uuid	O procedimento.
`procedure_name`	string	O nome do procedimento na hora do agendamento.
`appointment_date`	string	Data e hora (ISO 8601).
`status`	string	scheduled, confirmed, in_progress, completed, cancelled ou no_show.
`procedure_fields_data`	object \| null	Os campos extras do procedimento: o id de cada campo e o valor preenchido.
`notes`	string \| null	Observações.
`created_by_user_id`	uuid	Quem agendou.
`created_at`	string	ISO 8601.
`updated_at`	string	ISO 8601.
`deleted_at`	string \| null	Sempre null nas respostas.
`laudo_atualizado`	boolean	Só quando procedure_id veio no corpo: se o laudo do exame passou a mostrar o procedimento novo.

Request URL

https://api-endosystem.imagemais.com.br/api/appointments/b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f

curl -X PUT "https://api-endosystem.imagemais.com.br/api/appointments/b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"confirmed"}'

{
  "status": "confirmed"
}

{
  "status": "confirmed"
}

Respostas

{
  "id": "b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f",
  "patient_id": "9d3f1c2a-6b7e-4a8d-9f01-23456789abcd",
  ...

{
  "id": "b4d6f8a0-2c4e-4a6b-8d0f-1a3c5e7b9d2f",
  "patient_id": "9d3f1c2a-6b7e-4a8d-9f01-23456789abcd",
  "patient_name": "MARIA DA SILVA",
  "procedure_id": "3c1e9a7b-2d4f-4b6a-8e0c-5f7a9b1c3d2e",
  "procedure_name": "US OBSTÉTRICO",
  "appointment_date": "2026-10-20T09:30:00-03:00",
  "status": "confirmed",
  "procedure_fields_data": {
    "7a2b4c6d-8e0f-4a1b-9c3d-5e7f9a1b3c5d": "Unimed"
  },
  "notes": null,
  "created_by_user_id": "5f0c8a52-3b1e-4f7a-9c2d-1a6e7b8c9d01",
  "created_at": "2026-10-14T08:00:00-03:00",
  "updated_at": "2026-10-15T14:02:00-03:00",
  "deleted_at": null
}

{
  "error": "ID inválido"
}

{
  "error": "ID inválido"
}

{
  "error": "appointment_date inválido. Use formato ISO 8601"
}

{
  "error": "appointment_date inválido. Use formato ISO 8601"
}

{
  "error": "status deve ser um dos: scheduled, confirmed, in_progress, completed, cancelled, no_show"
}

{
  "error": "status deve ser um dos: scheduled, confirmed, in_progress, completed, cancelled, no_show"
}

{
  "error": "Informe o motivo da troca.",
  "code": "motivo_obrigatorio"
  ...

{
  "error": "Informe o motivo da troca.",
  "code": "motivo_obrigatorio"
}

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

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

{
  "error": "Procedimento não encontrado"
}

{
  "error": "Procedimento não encontrado"
}

{
  "error": "Você não tem a permissão \"Trocar o procedimento do exame\".",
  "code": "sem_permissao"
  ...

{
  "error": "Você não tem a permissão \"Trocar o procedimento do exame\".",
  "code": "sem_permissao"
}

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  ...

{
  "error": "Token ausente",
  "message": "Token de autenticação necessário.",
  "code": "TOKEN_MISSING"
}

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  ...

{
  "error": "Token expirado",
  "message": "Sua sessão expirou. Faça login novamente.",
  "code": "TOKEN_EXPIRED"
}

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  ...

{
  "error": "Token inválido",
  "message": "Token de autenticação inválido. Faça login novamente.",
  "code": "TOKEN_INVALID"
}

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  ...

{
  "error": "Acesso revogado",
  "message": "Seu acesso foi desativado. Procure o administrador da clínica.",
  "code": "ACCESS_REVOKED"
}

{
  "error": "Erro interno do servidor"
}

{
  "error": "Erro interno do servidor"
}