---
title: "[DRAFT] Update Personal Appointment"
method: PUT
path: "/calendars/{calendarId}/appointments/{appointmentId}"
tags: ["calendar"]
---

# \[DRAFT\] Update Personal Appointment

`PUT /calendars/{calendarId}/appointments/{appointmentId}`

## Request

- Base URL: `https://api.acculynx.com/api/v2`
- URL: `https://api.acculynx.com/api/v2/calendars/{calendarId}/appointments/{appointmentId}`
- Auth: HTTP bearer

[DRAFT] Use this endpoint to update an appointment(`Personal` type) from an existing calendar.

## Path parameters

- `calendarId` string, uuid, required
- `appointmentId` string, uuid, required

## Request body

- CalendarAppointmentPut
  - `title` string, required: The title of the calendar event.
  - `shareWithCustomerPortal` boolean: If the event is shared with the customer portal.
  - `notificationMessage` string: The message to be send to the appointment's attendees.
  - `jobId` string, uuid: The unique GUID of the job associated with the event, if any.
  - `location` string: The address where the appointment is to take place.
  - `details` string: other information related to the appointment.
  - `eventDateTime` CalendarEventDateTime, required
    - `start` string, date-time, required: The start date/time of the event.
    - `end` string, date-time, required: The end date/time of the event.
    - `allDay` boolean: Whether the event is an all day event.
    - `recurrence` CalendarRecurrence
      - `recurrenceType` 'Daily' | 'Weekly' | 'Monthly' | 'MonthlyOnDayOfMonth' | 'MonthlyOnDayOfWeek' | 'Yearly', required: The recurrence type of a calendar event/appointment
      - `daysOfWeek` CalendarDaysOfWeek[]: The days of the recurrence when the recurrence type is weekly.
      - `repeatEvery` integer, required: The frequency of the recurrence.
      - `repeatingType` 'Never' | 'NumberOfOccurrences' | 'StopDate': Indicates how a calendar event will be stopped.
      - `stopDate` string, date-time: Specifies when the recurrence will stop.
      - `numberOfOcurrences` integer: Specifies how many recurrences will be created when the RecurrenceRepeatingType is NumberOfOccurrences.
  - `attendees` string[]: The Ids of the users that will attend the appointment.

## Response `204`

No Content

## Other responses

- `400`: The request was malformed or contained invalid field values. Check the error response body for details.
- `401`: The API key provided is missing, invalid, or has been deactivated. Verify your API key and try again.
- `404`: The requested resource was not found. Verify the ID in the request path is correct and that the resource exists.
- `412`: The request could not be completed due to the failure of a required precondition.

## Changes

- **2026-11-03** `443924b00f43`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/acculynx/apis/acculynx-api-v2/changes/calendars/:calendarId/appointments/:appointmentId/put.md)

---

[API](https://skmtc.dev/acculynx/apis/acculynx-api-v2.md) - [All operations](https://skmtc.dev/acculynx/apis/acculynx-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/acculynx/apis/acculynx-api-v2/revisions/443924b00f43?raw)