Modifier un événement du planning
update_planning_eventUpdates one day of a planning entry, or all its days (times only). Only the given fields change.
Description
Modifie un événement du planning 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. estimateIds remplace les devis liés.
Required access
- Permission:
planning.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_planning_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 | Ressources affecté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). |
siteStateId | integer | optional | Nouvel état de chantier (id de siteStates dans get_agenda_lists). |
dossierId | integer | optional | Nouveau dossier lié (champ id de search_dossiers). |
estimateIds | integer[] | optional | Devis du dossier liés, qui remplacent les actuels ; liste vide pour les délier. |
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 planning | 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_planning_event",
"title": "Modifier un événement du planning",
"description": "Modifie un événement du planning 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. estimateIds remplace les devis liés.",
"inputSchema": {
"type": "object",
"properties": {
"eventId": {
"description": "Identifiant de l'événement (champ id de search_planning_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": "Ressources affecté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
},
"siteStateId": {
"description": "Nouvel état de chantier (id de siteStates dans get_agenda_lists).",
"type": [
"integer",
"null"
],
"default": null
},
"dossierId": {
"description": "Nouveau dossier lié (champ id de search_dossiers).",
"type": [
"integer",
"null"
],
"default": null
},
"estimateIds": {
"description": "Devis du dossier liés, qui remplacent les actuels ; liste vide pour les délier.",
"type": [
"array",
"null"
],
"items": {
"type": "integer"
},
"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 planning",
"destructiveHint": true,
"idempotentHint": false,
"openWorldHint": false,
"readOnlyHint": false
}
}