PATCH/api/appointments/{id}

Atualizar Agendamentos

Atualiza um ou mais agendamentos

Access Token

Para realizar requisições GET, POST, PUT, DELETE e PATCH nos endpoints da API você precisa de uma chave de autorização. Chamamos essa chave de accessToken.

Para ter acesso ao accessToken, é necessário que o usuário master da licença efetue a liberação deste pela interface do ImageMais Clinic. O accessToken tem validade de 1 hora.

Headers

AuthorizationOBRIGATÓRIO
Tipo:string
Token de autenticação no formato Bearer {accessToken}
Content-TypeOBRIGATÓRIO
Tipo:application/json
Tipo de conteúdo (application/json)
acceptOBRIGATÓRIO
Tipo:*/*
Tipo de conteúdo aceito

Parâmetros

idOBRIGATÓRIO
Tipo:number
ID do agendamento

Este parâmetro representa o identificador único do agendamento. O ID do agendamento deve ser um número inteiro que identifica um agendamento específico no sistema.

Observação: Para encontrar o ID do agendamento, para acessar a página de listar agendamentos.

patientOPCIONAL
Tipo:object
Objeto contendo os dados do paciente

Este parâmetro representa um objeto contendo os dados do paciente que será atualizado no agendamento. O objeto deve conter as seguintes propriedades:

Propriedades do objeto patient:

  • name (string, obrigatório): Nome do paciente
  • phone (string, obrigatório): Telefone do paciente (formato: (81) 99999-9999)
  • dateBirth (string, obrigatório): Data de nascimento do paciente (formato: YYYY-MM-DD)
  • cpf (string, opcional): CPF do paciente (formato: 123.456.789-00)
notesOPCIONAL
Tipo:string
Observações sobre o agendamento

Request URL

https://api-dev.imagemais.com/api/appointments/92
curl -X 'PATCH' \
  'https://api-dev.imagemais.com/api/appointments/92' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOjMyLCJhY2NvdW50SWQiOjEsImlhdCI6MTc2NjQ5Mjk1NSwiZXhwIjoxNzY2NDk2NTU1LCJhdWQiOiJodHRwczovL2FwaS1kZXYuaW1hZ2VtYWlzLmNvbSIsImlzcyI6Imh0dHBzOi8vYXBwLWRldi5pbWFnZW1haXMuY29tIn0.AhBT8vh8EgVQbgxfGlNfmHMyG-IKCqbXgQapWXAjxoQ' \
  -H 'Content-Type: application/json' \
  -d '{
  "patient": {
    "name": "João Silva",
    "phone": "(81) 99999-9999",
    "dateBirth": "1990-01-01",
    "cpf": "123.456.789-00"
  },
  "notes": "Observações sobre o agendamento"
}'
{
  "patient": {
    "name": "João Silva",
  ...
{
  "patient": {
    "name": "João Silva",
    "phone": "(81) 99999-9999",
    "dateBirth": "1990-01-01",
    "cpf": "123.456.789-00"
  },
  "notes": "Observações sobre o agendamento"
}

Respostas

{
  "id": 92,
  "date": "2025-12-24T00:00:00.000Z",
  ...
{
  "id": 92,
  "date": "2025-12-24T00:00:00.000Z",
  "startTime": "09:00",
  "endTime": "09:15",
  "notes": "Observações sobre o agendamento",
  "accountId": 1,
  "createdAt": "2025-12-23T11:14:00.829Z",
  "updatedAt": "2025-12-23T12:29:25.557Z",
  "deletedAt": null,
  "doctor": {
    "id": 1,
    "name": "Dr Victor"
  },
  "patient": {
    "dateBirth": "1990-01-01T00:00:00.000Z",
    "id": 9321,
    "name": "João Silva",
    "cpf": "12345678900",
    "contact": {
      "phone": "(81) 99999-9999"
    }
  },
  "status": {
    "id": 1,
    "name": "Agendado",
    "color": "#ffc107"
  },
  "appointmentProcedures": {
    "price": "100",
    "discountsAppointmentProcedures": [
      {
        "discountId": 3,
        "value": "10",
        "discount": {
          "id": 3,
          "name": "Desconto nos procedimentos",
          "fixed": "10",
          "percentage": null,
          "expirationDate": null
        }
      }
    ],
    "procedure": {
      "id": 3699,
      "name": "Ultrassom: Tireoide",
      "price": "100"
    }
  }
}
{
  "message": [
    "patient.O nome é necessário",
  ...
{
  "message": [
    "patient.O nome é necessário",
    "patient.name must be a string"
  ],
  "error": "Bad Request",
  "statusCode": 400
}
{
  "message": [
    "patient.O telefone é necessário",
  ...
{
  "message": [
    "patient.O telefone é necessário",
    "patient.phone must be a string"
  ],
  "error": "Bad Request",
  "statusCode": 400
}
{
  "message": [
    "patient.A data de nascimento é necessária",
  ...
{
  "message": [
    "patient.A data de nascimento é necessária",
    "patient.dateBirth must be a valid ISO 8601 date string"
  ],
  "error": "Bad Request",
  "statusCode": 400
}
{
  "statusCode": 401,
  "message": "invalid token"
  ...
{
  "statusCode": 401,
  "message": "invalid token"
}
{
  "statusCode": 401,
  "message": "jwt expired"
  ...
{
  "statusCode": 401,
  "message": "jwt expired"
}
{
  "statusCode": 500,
  "message": "Internal server error"
  ...
{
  "statusCode": 500,
  "message": "Internal server error"
}