Passer au contenu principal
PATCH
Mettre à jour un endpoint de webhook
Met à jour l’URL, la description, les événements, les workspaces ou l’activation d’un endpoint. N’envoyez que les champs à modifier. Réactiver un endpoint désactivé pour cause d’échecs efface son état d’échec. Les webhooks d’intégration nécessitent une offre Business, Agency Business ou Enterprise active. Modifier un endpoint exige aussi un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Webhooks d’intégration et Écrire des données.
string
requis
Jeton bearer de votre équipe.
string
requis
L’ETag de Obtenir un endpoint de webhook, guillemets compris. Utilisez * pour écrire sans condition.
string
requis
Identifiant de l’endpoint.
string
URL HTTPS publique, 2048 caractères au maximum.
string | null
Description libre, 200 caractères au maximum, ou null pour l’effacer.
string[]
Liste de remplacement complète de types d’événements, au moins un.
string[]
Liste de remplacement complète de 100 workspaces au maximum. Un tableau vide reçoit les événements de tous les workspaces.
boolean
false met l’envoi en pause ; true le reprend.
Fournissez au moins un champ.

Réponse

Renvoie 200, le nouvel ETag et l’endpoint, avec les champs décrits dans Lister les endpoints de webhook.

Requête et réponse synthétiques

Cet exemple suppose que l’ETag que vous avez lu en dernier est "0".

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie 403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.