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.

Requires set_notes with CRM or BackOffice access. Manager permissions and brand/desk scope are resolved from the cached staff manager record. Access is checked for the current event and for the target event after requested changes are applied.

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
      }
    ]
  }
}