Modifier un événement du calendrier
update_calendar_eventDescription
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.
Accès requis
- Au moins une de ces permissions :
calendar.list.viewoucalendar-hybrid.list.view - Société ouverte aux outils d'écriture (Paramètres → Intégration IA).
- Sans ces conditions, l'outil n'apparaît pas dans
tools/listet son appel est refusé.
Paramètres
| Nom | Type | Présence | Description |
|---|---|---|---|
eventId | integer | obligatoire | Identifiant de l'événement (champ id de search_calendar_events). |
scope | string | facultatif | occurrence (par défaut) : ce jour seulement ; series : tous les jours de l'événement. |
includePastDays | boolean | facultatif | Avec scope series : modifier aussi les jours passés (faux par défaut). |
subject | string | facultatif | Nouvel objet. |
date | string (date) | facultatif | Nouveau jour (AAAA-MM-JJ), avec scope occurrence seulement. |
startTime | string | facultatif | Nouvelle heure de début (HH:mm). |
endTime | string | facultatif | Nouvelle heure de fin (HH:mm). |
resourceIds | integer[] | facultatif | Personnes concernées, qui remplacent les actuelles (champ id de resources dans get_agenda_lists). |
typeId | integer | facultatif | Nouveau type d'événement (id de types dans get_agenda_lists). |
dossierId | integer | facultatif | Nouveau dossier lié (champ id de search_dossiers). |
location | string | facultatif | Nouveau lieu ; chaîne vide pour l'effacer. |
description | string | facultatif | Nouvelle description, en texte simple ; chaîne vide pour l'effacer. |
Résultat
Le résultat est renvoyé en contenu structuré (structuredContent), conforme au schéma de sortie ci-dessous, et en texte JSON pour les clients qui ne lisent pas le contenu structuré. Une erreur est renvoyée avec isError: true et un message en français qui explique quoi corriger.
Champs du résultat
| Nom | Type | Présence | Description |
|---|---|---|---|
description | string | peut être null | Description de l'événement (masquée pour un événement privé d'autrui). |
dossierSiteAddress | string | peut être null | Adresse du chantier du dossier lié. |
dossierClient | string | peut être null | 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 | peut être null | 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 | peut être null | 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 | peut être null | Type d'événement (chantier, rendez-vous, congé, intervention…). |
siteState | string | peut être null | État de chantier (planifié, validé…), pour le planning. |
location | string | peut être null | Lieu saisi sur l'événement (masqué pour un événement privé d'autrui). |
isPrivate | boolean | Vrai pour un événement privé. | |
dossierId | integer | peut être null | Identifiant du dossier lié (à passer à get_dossier). |
dossierReference | string | peut être null | Référence du dossier lié. |
dossierIndication | string | peut être null | Intitulé court du dossier lié. |
assignees | string[] | Personnes affectées à cette occurrence. |
Annotations MCP
| Annotation | Valeur | Signification |
|---|---|---|
title | Modifier un événement du calendrier | Nom lisible affiché par le client MCP. |
readOnlyHint | non | L'outil ne modifie rien. |
destructiveHint | oui | L'outil peut modifier ou supprimer des données existantes, ou déclencher une action irréversible. |
idempotentHint | non | Rappeler l'outil avec les mêmes arguments n'a pas d'effet supplémentaire. |
openWorldHint | non | L'outil lit des courriels ou le contenu d'un document, ou contacte un service extérieur. |
Définition JSON
Entrée exacte de tools/list
{
"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
}
}