
Supprimer une réunion avec l'API Zoom
Supprime une réunion. Sans occurrence_id, une réunion récurrente est supprimée avec toutes ses occurrences.
- Identifiant
- zoom_delete_meeting
L'appel
POST https://connect.reportei.com/api/tools/zoom_delete_meeting/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"meetingId": 1
}
}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 |
|---|---|---|---|
| meetingId | integer | Oui | Meeting ID, from List meetings. |
| occurrence_id | string | Non | Deletes only this occurrence of a recurring meeting, from the occurrences in Get meeting. |
| cancel_meeting_reminder | boolean | Non | true emails the registrants about the cancellation. The default is false. |
| schedule_for_reminder | boolean | Non | true emails the host and the alternative hosts about the cancellation. |
Connexions possibles
Votre client connecte son compte Zoom 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/zoom, 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/zoom_delete_meeting. Il devient la définition de tool de votre agent sans conversion.
Autres tools Zoom
- Obtenir un utilisateurGETRenvoie le profil d'un utilisateur : nom, email, fuseau horaire, ID de réunion personnelle et type de forfait.
- Lister les réunionsGETListe les réunions planifiées d'un utilisateur ; les réunions instantanées ne sont pas incluses. La réponse contient meetings et next_page_token : passez next_page_token pour lire la page suivante.
- Obtenir une réunionGETRenvoie une réunion avec join_url, start_url, paramètres et, pour une réunion récurrente, ses occurrences. Le start_url expire au bout de deux heures : relisez-le ici quand nécessaire.
- Créer une réunionPOSTPlanifie une réunion pour un utilisateur et la renvoie avec join_url et start_url. Zoom accepte jusqu'à 100 de ces appels par jour et par hôte.
- Mettre à jour une réunionPATCHMet à jour une réunion ; seuls les champs envoyés changent. Avec occurrence_id, modifie une occurrence d'une réunion récurrente. Zoom accepte jusqu'à 100 mises à jour par jour et par réunion.
- Obtenir l'invitation d'une réunionGETRenvoie le texte d'invitation d'une réunion, avec le lien et les informations d'appel, prêt à envoyer aux invités.
- Lister les inscrits d'une réunionGETListe les inscrits d'une réunion dont l'inscription est activée. Seuls les inscrits approuvés reviennent, sauf indication contraire de status. Nécessite un forfait Pro ou supérieur. Passez next_page_token pour lire la page suivante.
- Inscrire un participant à la réunionPOSTInscrit une personne à une réunion dont l'inscription est activée et renvoie le registrant_id et le join_url personnel. Zoom peut envoyer un email à l'inscrit, selon les paramètres de la réunion.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
