Modifier un événement du calendrier
update_calendar_eventUpdates one day of a calendar event, or all its days (times only). Another user's private event cannot be changed.
Description
Modifie un événement du calendrier Oxygenius. Modifie un seul jour (scope occurrence, par défaut) ou tous les jours de l'événement (scope series : les jours à venir, et aussi les jours passés avec includePastDays). Seuls les champs fournis changent ; une chaîne vide efface le lieu ou la description ; resourceIds remplace les personnes affectées. Pour un jour, date le déplace à un autre jour ; pour la série, seuls les horaires changent. L'application recrée souvent les lignes : les identifiants des jours modifiés changent et ceux d'une recherche antérieure ne valent plus. Avant l'appel, annoncer la modification et sa portée, et attendre l'accord de l'utilisateur. Renvoie le jour modifié, sous son identifiant actuel. L'événement privé d'un autre utilisateur n'est pas modifiable. Le calendrier recrée les jours modifiés et leur copie Outlook : ce qui n'a été ajouté que dans Outlook (pièces jointes, participants externes) est perdu, à signaler à l'utilisateur pour un événement venu d'Outlook. Tant que la synchronisation Microsoft 365 d'un événement n'est pas terminée, l'application refuse sa modification : réessayer un peu plus tard.
Required access
- At least one of these permissions:
calendar.list.vieworcalendar-hybrid.list.view - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
eventId | integer | required | Identifiant de l'événement (champ id de search_calendar_events). |
scope | string | optional | occurrence (par défaut) : ce jour seulement ; series : tous les jours de l'événement. |
includePastDays | boolean | optional | Avec scope series : modifier aussi les jours passés (faux par défaut). |
subject | string | optional | Nouvel objet. |
date | string (date) | optional | Nouveau jour (AAAA-MM-JJ), avec scope occurrence seulement. |
startTime | string | optional | Nouvelle heure de début (HH:mm). |
endTime | string | optional | Nouvelle heure de fin (HH:mm). |
resourceIds | integer[] | optional | Personnes concernées, qui remplacent les actuelles (champ id de resources dans get_agenda_lists). |
typeId | integer | optional | Nouveau type d'événement (id de types dans get_agenda_lists). |
dossierId | integer | optional | Nouveau dossier lié (champ id de search_dossiers). |
location | string | optional | Nouveau lieu ; chaîne vide pour l'effacer. |
description | string | optional | Nouvelle description, en texte simple ; chaîne vide pour l'effacer. |
Result
The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.
Result fields
| Name | Type | Presence | Description |
|---|---|---|---|
description | string | nullable | Description de l'événement (masquée pour un événement privé d'autrui). |
dossierSiteAddress | string | nullable | Adresse du chantier du dossier lié. |
dossierClient | string | nullable | Client (tiers propriétaire) du dossier lié. |
estimates | object[] | Devis liés à l'événement (vide sans accès aux devis). | |
estimates[].estimateId | integer | Identifiant du devis (à passer à get_estimate). | |
estimates[].reference | string | nullable | Référence du devis. |
id | integer | Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event). | |
kind | string | planning ou calendar : écran d'origine de l'événement. | |
subject | string | nullable | Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur. |
start | string (date-time) | Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00). | |
end | string (date-time) | Fin, en heure locale belge avec son décalage UTC. | |
type | string | nullable | Type d'événement (chantier, rendez-vous, congé, intervention…). |
siteState | string | nullable | État de chantier (planifié, validé…), pour le planning. |
location | string | nullable | Lieu saisi sur l'événement (masqué pour un événement privé d'autrui). |
isPrivate | boolean | Vrai pour un événement privé. | |
dossierId | integer | nullable | Identifiant du dossier lié (à passer à get_dossier). |
dossierReference | string | nullable | Référence du dossier lié. |
dossierIndication | string | nullable | Intitulé court du dossier lié. |
assignees | string[] | Personnes affectées à cette occurrence. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Modifier un événement du calendrier | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | yes | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | no | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "update_calendar_event",
"title": "Modifier un événement du calendrier",
"description": "Modifie un événement du calendrier Oxygenius. Modifie un seul jour (scope occurrence, par défaut) ou tous les jours de l'événement (scope series : les jours à venir, et aussi les jours passés avec includePastDays). Seuls les champs fournis changent ; une chaîne vide efface le lieu ou la description ; resourceIds remplace les personnes affectées. Pour un jour, date le déplace à un autre jour ; pour la série, seuls les horaires changent. L'application recrée souvent les lignes : les identifiants des jours modifiés changent et ceux d'une recherche antérieure ne valent plus. Avant l'appel, annoncer la modification et sa portée, et attendre l'accord de l'utilisateur. Renvoie le jour modifié, sous son identifiant actuel. L'événement privé d'un autre utilisateur n'est pas modifiable. Le calendrier recrée les jours modifiés et leur copie Outlook : ce qui n'a été ajouté que dans Outlook (pièces jointes, participants externes) est perdu, à signaler à l'utilisateur pour un événement venu d'Outlook. Tant que la synchronisation Microsoft 365 d'un événement n'est pas terminée, l'application refuse sa modification : réessayer un peu plus tard.",
"inputSchema": {
"type": "object",
"properties": {
"eventId": {
"description": "Identifiant de l'événement (champ id de search_calendar_events).",
"type": "integer"
},
"scope": {
"description": "occurrence (par défaut) : ce jour seulement ; series : tous les jours de l'événement.",
"type": [
"string",
"null"
],
"default": null
},
"includePastDays": {
"description": "Avec scope series : modifier aussi les jours passés (faux par défaut).",
"type": "boolean",
"default": false
},
"subject": {
"description": "Nouvel objet.",
"type": [
"string",
"null"
],
"default": null
},
"date": {
"description": "Nouveau jour (AAAA-MM-JJ), avec scope occurrence seulement.",
"type": [
"string",
"null"
],
"format": "date",
"default": null
},
"startTime": {
"description": "Nouvelle heure de début (HH:mm).",
"type": [
"string",
"null"
],
"default": null
},
"endTime": {
"description": "Nouvelle heure de fin (HH:mm).",
"type": [
"string",
"null"
],
"default": null
},
"resourceIds": {
"description": "Personnes concernées, qui remplacent les actuelles (champ id de resources dans get_agenda_lists).",
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"default": null
},
"typeId": {
"description": "Nouveau type d'événement (id de types dans get_agenda_lists).",
"type": [
"integer",
"null"
],
"default": null
},
"dossierId": {
"description": "Nouveau dossier lié (champ id de search_dossiers).",
"type": [
"integer",
"null"
],
"default": null
},
"location": {
"description": "Nouveau lieu ; chaîne vide pour l'effacer.",
"type": [
"string",
"null"
],
"default": null
},
"description": {
"description": "Nouvelle description, en texte simple ; chaîne vide pour l'effacer.",
"type": [
"string",
"null"
],
"default": null
}
},
"required": [
"eventId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"description": {
"description": "Description de l'événement (masquée pour un événement privé d'autrui).",
"type": [
"string",
"null"
]
},
"dossierSiteAddress": {
"description": "Adresse du chantier du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierClient": {
"description": "Client (tiers propriétaire) du dossier lié.",
"type": [
"string",
"null"
]
},
"estimates": {
"description": "Devis liés à l'événement (vide sans accès aux devis).",
"type": "array",
"items": {
"type": "object",
"properties": {
"estimateId": {
"description": "Identifiant du devis (à passer à get_estimate).",
"type": "integer"
},
"reference": {
"description": "Référence du devis.",
"type": [
"string",
"null"
]
}
},
"required": [
"estimateId"
]
}
},
"id": {
"description": "Identifiant de l'événement (à passer à get_planning_event ou get_calendar_event).",
"type": "integer"
},
"kind": {
"description": "planning ou calendar : écran d'origine de l'événement.",
"type": "string"
},
"subject": {
"description": "Objet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.",
"type": [
"string",
"null"
]
},
"start": {
"description": "Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).",
"type": "string",
"format": "date-time"
},
"end": {
"description": "Fin, en heure locale belge avec son décalage UTC.",
"type": "string",
"format": "date-time"
},
"type": {
"description": "Type d'événement (chantier, rendez-vous, congé, intervention…).",
"type": [
"string",
"null"
]
},
"siteState": {
"description": "État de chantier (planifié, validé…), pour le planning.",
"type": [
"string",
"null"
]
},
"location": {
"description": "Lieu saisi sur l'événement (masqué pour un événement privé d'autrui).",
"type": [
"string",
"null"
]
},
"isPrivate": {
"description": "Vrai pour un événement privé.",
"type": "boolean"
},
"dossierId": {
"description": "Identifiant du dossier lié (à passer à get_dossier).",
"type": [
"integer",
"null"
]
},
"dossierReference": {
"description": "Référence du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierIndication": {
"description": "Intitulé court du dossier lié.",
"type": [
"string",
"null"
]
},
"assignees": {
"description": "Personnes affectées à cette occurrence.",
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"kind",
"start",
"end",
"isPrivate"
]
},
"annotations": {
"title": "Modifier un événement du calendrier",
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}