Skip to content

MngUpdateCalendarEvent

Updates a calendar event. If participants or participant_manager_ids is sent, the event participants are replaced. If neither field is sent, existing participants are preserved.

If both participants and participant_manager_ids are sent, participants is used.

To cancel an event, send status: 2. There is no separate cancel command.

Validation

  • If start_time or end_time is changed, final event values must satisfy start_time > 0 and end_time >= start_time.
  • ast_json can be null, string, object, or array.

Request

{
  "command": "MngUpdateCalendarEvent",
  "extID": "1",
  "data": {
    "id": 1,
    "title": "Retention sync updated",
    "start_time": 1710000300,
    "end_time": 1710003900,
    "participant_manager_ids": [10, 12]
  }
}

Request Data

Field Type Required Description
id int Yes Calendar event id
title string No Calendar title
start_time, end_time time_t No Event time range
brand, desk string No Scope fields
owner_manager_id int No Organizer/main assignee
type, status, priority int No Event enums
ast_json object/array/string/null No Visible AST message body
participant_manager_ids int[] No Replacement participant ids
participants object[] No Replacement detailed participant rows

Participants Object

Field Type Required Description
manager_id int Yes Participant manager id
role int No 0 organizer, 1 required, 2 optional
status int No 0 invited, 1 accepted, 2 declined, 3 tentative
created_time time_t No Optional create timestamp
updated_time time_t No Optional update timestamp

Response Data

Returns the full event object with participants. Example is shortened.

{
  "event": {
    "id": 1,
    "title": "Retention sync updated",
    "status": 0,
    "participants": [
      {
        "event_id": 1,
        "manager_id": 10,
        "role": 0,
        "status": 1
      }
    ]
  }
}