Mettre à jour un événement avec l'API Outlook Calendar
Modifie un événement et le renvoie. Seuls les champs envoyés changent. Sur une réunion organisée par l'utilisateur, Outlook envoie la modification par e-mail aux participants. N'envoyez pas de nouveau body pour une réunion en ligne : les informations de connexion sont dans le corps et seraient perdues.
- Identifiant
- outlook_calendar_update_event
L'appel
POST https://connect.reportei.com/api/tools/outlook_calendar_update_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"event_id": "<event_id>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| event_id | string | Oui | Event id from List events. The id of an occurrence acts on that occurrence; its seriesMasterId acts on the whole series. |
| subject | string | Non | Title of the event. |
| body | object | Non | Description of the event. contentType is text or html. |
| start | object | Non | When the event starts. An all-day event starts at midnight. |
| end | object | Non | When the event ends. An all-day event ends at midnight of the next day, in the same time zone as start. |
| isAllDay | boolean | Non | true for an all-day event, with start and end at midnight. |
| location | object | Non | Where the event happens. |
| attendees | array | Non | People, rooms or equipment invited. Outlook emails them the invitation. |
| isOnlineMeeting | boolean | Non | true adds an online meeting, together with onlineMeetingProvider. |
| onlineMeetingProvider | string | Non | teamsForBusiness adds a Microsoft Teams link. It needs a work or school account.Valeurs : teamsForBusiness |
| showAs | string | Non | How the time shows in the calendar. oof is out of office.Valeurs : free, tentative, busy, oof, workingElsewhere |
| importance | string | Non | Importance of the event.Valeurs : low, normal, high |
| sensitivity | string | Non | Privacy of the event.Valeurs : normal, personal, private, confidential |
| isReminderOn | boolean | Non | true sets a reminder. |
| reminderMinutesBeforeStart | integer | Non | Minutes before the start that the reminder shows. |
| categories | array | Non | Category names of the user. The list replaces the current one. |
| recurrence | object | Non | Repetition. Besides type and interval, pattern needs: weekly, daysOfWeek and firstDayOfWeek; absoluteMonthly, dayOfMonth; relativeMonthly, daysOfWeek; absoluteYearly, dayOfMonth and month; relativeYearly, daysOfWeek and month. range.startDate is the date of start; range.type endDate needs endDate, and numbered needs numberOfOccurrences. |
| allowNewTimeProposals | boolean | Non | false stops invitees from proposing another time. The default is true. |
| responseRequested | boolean | Non | false asks invitees for no response. The default is true. |
Connexions possibles
Votre client connecte son compte Outlook Calendar une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
OAuth avec l'app de votre produit
Vous enregistrez une fois l'app OAuth de votre produit, avec POST /api/merchants/credentials/outlook_calendar, et votre client autorise le compte sur un écran de consentement. Connect renouvelle le token avant son expiration.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/outlook_calendar_update_event. Il devient la définition de tool de votre agent sans conversion.
Autres tools Outlook Calendar
- Lister les calendriersGETListe les calendriers de l'utilisateur, avec id, name, isDefaultCalendar, canEdit et owner. Utilisez l'id comme calendar_id. Seule la première page est renvoyée.
- Lister les événementsGETListe les événements d'un calendrier entre deux instants, avec les événements récurrents développés en occurrences qui ont leur propre id. start et end sont en UTC. Seule la première page est renvoyée : quand la réponse contient @odata.nextLink, réinterrogez avec une fenêtre plus courte.
- Consulter un événementGETRenvoie un événement avec son corps en texte brut, start et end en UTC, le lieu, les participants avec leurs réponses, l'organisateur, onlineMeeting avec le lien de connexion, la récurrence et webLink.
- Créer un événementPOSTCrée un événement dans un calendrier et le renvoie avec id et webLink. Avec attendees, Outlook envoie aussitôt les invitations par e-mail, et cela ne peut pas être désactivé.
- Supprimer un événementDELETESupprime un événement du calendrier. Quand l'utilisateur organise la réunion, Outlook envoie une annulation par e-mail aux participants.
- Accepter un événementPOSTAccepte une invitation à une réunion et, sauf si sendResponse vaut false, envoie la réponse par e-mail à l'organisateur. La réponse est 202 sans corps.
- Refuser un événementPOSTRefuse une invitation à une réunion, en proposant éventuellement un autre horaire, et, sauf si sendResponse vaut false, envoie la réponse par e-mail à l'organisateur. La réponse est 202 sans corps.
- Accepter un événement provisoirementPOSTAccepte provisoirement une invitation à une réunion, en proposant éventuellement un autre horaire, et, sauf si sendResponse vaut false, envoie la réponse par e-mail à l'organisateur. La réponse est 202 sans corps.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
