Modifier un événement du planning

Tool nameupdate_planning_event
WriteDestructive

Updates one day of a planning entry, or all its days (times only). Only the given fields change.

Description

Exact text sent to the model by tools/list (French, the language of the data):

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

Parameters

NameTypePresenceDescription
eventIdintegerrequiredIdentifiant de l'événement (champ id de search_planning_events).
scopestringoptionaloccurrence (par défaut) : ce jour seulement ; series : tous les jours de l'événement.
includePastDaysbooleanoptionalAvec scope series : modifier aussi les jours passés (faux par défaut).
Default : false
subjectstringoptionalNouvel objet.
datestring (date)optionalNouveau jour (AAAA-MM-JJ), avec scope occurrence seulement.
startTimestringoptionalNouvelle heure de début (HH:mm).
endTimestringoptionalNouvelle heure de fin (HH:mm).
resourceIdsinteger[]optionalRessources affectées, qui remplacent les actuelles (champ id de resources dans get_agenda_lists).
typeIdintegeroptionalNouveau type d'événement (id de types dans get_agenda_lists).
siteStateIdintegeroptionalNouvel état de chantier (id de siteStates dans get_agenda_lists).
dossierIdintegeroptionalNouveau dossier lié (champ id de search_dossiers).
estimateIdsinteger[]optionalDevis du dossier liés, qui remplacent les actuels ; liste vide pour les délier.
locationstringoptionalNouveau lieu ; chaîne vide pour l'effacer.
descriptionstringoptionalNouvelle 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
NameTypePresenceDescription
descriptionstringnullableDescription de l'événement (masquée pour un événement privé d'autrui).
dossierSiteAddressstringnullableAdresse du chantier du dossier lié.
dossierClientstringnullableClient (tiers propriétaire) du dossier lié.
estimatesobject[]Devis liés à l'événement (vide sans accès aux devis).
estimates[].estimateIdintegerIdentifiant du devis (à passer à get_estimate).
estimates[].referencestringnullableRéférence du devis.
idintegerIdentifiant de l'événement (à passer à get_planning_event ou get_calendar_event).
kindstringplanning ou calendar : écran d'origine de l'événement.
subjectstringnullableObjet de l'événement ; « Privé » pour l'événement privé d'un autre utilisateur.
startstring (date-time)Début, en heure locale belge avec son décalage UTC (ex. 2026-10-14T08:00:00+02:00).
endstring (date-time)Fin, en heure locale belge avec son décalage UTC.
typestringnullableType d'événement (chantier, rendez-vous, congé, intervention…).
siteStatestringnullableÉtat de chantier (planifié, validé…), pour le planning.
locationstringnullableLieu saisi sur l'événement (masqué pour un événement privé d'autrui).
isPrivatebooleanVrai pour un événement privé.
dossierIdintegernullableIdentifiant du dossier lié (à passer à get_dossier).
dossierReferencestringnullableRéférence du dossier lié.
dossierIndicationstringnullableIntitulé court du dossier lié.
assigneesstring[]Personnes affectées à cette occurrence.

MCP annotations

AnnotationValueMeaning
titleModifier un événement du planningHuman-readable name shown by the MCP client.
readOnlyHintnoThe tool changes nothing.
destructiveHintyesThe tool may change or delete existing data, or trigger an irreversible action.
idempotentHintnoCalling it again with the same arguments has no further effect.
openWorldHintnoThe 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
  }
}