Mettre à jour un événement planifié avec l'API Discord

Met à jour un événement et le renvoie. Les champs omis gardent leur valeur. status 2 démarre l'événement, 3 termine un événement actif et 4 annule un événement planifié ; après 3 ou 4, l'événement ne peut plus changer.

Identifiant
discord_update_scheduled_event

L'appel

POST https://connect.reportei.com/api/tools/discord_update_scheduled_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json

{
  "customer_toolkit": "<connection UUID>",
  "arguments": {
    "guild_id": "<guild_id>",
    "guild_scheduled_event_id": "<guild_scheduled_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ètreTypeObligatoireDescription
guild_idstringOuiId of the server, from List guilds.
guild_scheduled_event_idstringOuiId of the event, from List scheduled events.
namestringNonNew name of the event, up to 100 characters.
descriptionstringNonNew description of the event, up to 1000 characters.
statusintegerNon2 starts a scheduled event, 3 ends an active one and 4 cancels a scheduled one.Valeurs : 1, 2, 3, 4
scheduled_start_timestringNonNew start, ISO 8601 with offset.
scheduled_end_timestringNonNew end, ISO 8601 with offset. Required when changing entity_type to 3.
entity_typeintegerNonWhere it happens: 1 in a stage channel, 2 in a voice channel or 3 outside Discord. Changing to 3 also needs entity_metadata.location, scheduled_end_time and channel_id sent as null.Valeurs : 1, 2, 3
channel_idstringNonId of the voice or stage channel, from List channels. Send null when changing entity_type to 3.
entity_metadataobjectNonLocation of an event outside Discord. Ignored for the other types.
privacy_levelintegerNonAlways 2: the event is visible to the members of the server.Valeurs : 2

Connexions possibles

Votre client connecte son compte Discord une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

Clé d'API

Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.

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/discord_update_scheduled_event. Il devient la définition de tool de votre agent sans conversion.

Autres tools Discord

Voir les 12 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.