Skip to content

Update an event

Request

Partially updates an event. When participants are provided, exactly one must be flagged is_organizer and exactly one is_creator, with unique user_id. Requires SITE_CALENDAR:WRITE.

Security
bearerAuth
Path
eventIdintegerrequired

ID of the event to update.

Bodyapplication/jsonrequired
typestring or null
starts_atstring or null
Example:"2026-01-15T09:00:00Z"
ends_atstring or null
Example:"2026-01-15T10:00:00Z"
all_dayboolean or null
titlestring or null
locationstring or null
location_geoobject or null
sequence_durationinteger or null
gathering_gaugeinteger or null
commute_durationinteger or null
communicate_locationboolean or null
is_confidentialboolean or null
remind_time_in_mininteger or null, >= 0
appointment_modestring or null
Enum:"OFFICE""PHONE""PRODUCT""VISIO"null
participantsArray of objects or null(EventParticipantInput)
productsArray of integers or null
contactsArray of integers or null
notesstring or null
visio_urlstring or null
immo360_organizer_urlstring or null
immo360_participation_urlstring or null
archivedboolean or null
parent_idinteger or null
recurrenceobject or null(EventRecurrence)

iCalendar RRULE-style recurrence definition. When present, dtstart, freq and interval are required. The by* arrays follow the RFC 5545 recurrence semantics.

curl -i -X PATCH \
  'https://api-doc.immo-facile.com/_mock/openapi/calendar/events/{eventId}' \
  -H 'Authorization: Bearer <YOUR_opaque_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "string",
    "starts_at": "2026-01-15T09:00:00Z",
    "ends_at": "2026-01-15T10:00:00Z",
    "all_day": true,
    "title": "string",
    "location": "string",
    "location_geo": {
      "lat": 0,
      "lng": 0
    },
    "sequence_duration": 0,
    "gathering_gauge": 0,
    "commute_duration": 0,
    "communicate_location": true,
    "is_confidential": true,
    "remind_time_in_min": 0,
    "appointment_mode": "OFFICE",
    "participants": [
      {
        "user_id": 0,
        "is_creator": true,
        "is_organizer": true
      }
    ],
    "products": [
      0
    ],
    "contacts": [
      0
    ],
    "notes": "string",
    "visio_url": "string",
    "immo360_organizer_url": "string",
    "immo360_participation_url": "string",
    "archived": true,
    "parent_id": 0,
    "recurrence": {
      "dtstart": "2026-01-15T09:00:00Z",
      "freq": "yearly",
      "interval": 1,
      "count": 1,
      "until": "2026-12-31T23:59:59Z",
      "bymonth": [
        1
      ],
      "bymonthday": [
        -31
      ],
      "bynmonthday": [
        0
      ],
      "byyearday": [
        -366
      ],
      "byweekno": [
        -53
      ],
      "byweekday": [
        "MO"
      ],
      "bynweekday": [
        [
          0
        ]
      ],
      "bysetpos": [
        0
      ],
      "exdate": [
        "2026-02-15T09:00:00Z"
      ]
    }
  }'

Responses

Event updated

Bodyapplication/json
dataobject(EventResponse)

A calendar event. The set of populated fields depends on the event type and on the information supplied when the event was created.

Response
{
  "data": {
    "id": 0,
    "type": "VISIT",
    "starts_at": "2026-01-15T09:00:00Z",
    "ends_at": "2026-01-15T10:00:00Z",
    "all_day": true,
    "title": "string",
    "location": "string",
    "location_geo": { … },
    "sequence_duration": 0,
    "gathering_gauge": 0,
    "commute_duration": 0,
    "communicate_location": true,
    "is_confidential": true,
    "remind_time_in_min": 0,
    "appointment_mode": "OFFICE",
    "participants": [ … ],
    "products": [ … ],
    "contacts": [ … ],
    "notes": "string",
    "visio_url": "string",
    "immo360_organizer_url": "string",
    "immo360_participation_url": "string",
    "archived": true,
    "parent_id": 0,
    "recurrence": {}
  }
}