Mettre à jour un endpoint webhook

PATCH 
/api/v1/workspaces/:workspace_id/webhook_endpoints/:id

Met à jour un endpoint webhook existant. event_type est immuable et silencieusement ignoré s'il est présent dans le corps de la requête. Seule l'application OAuth qui a créé l'endpoint peut le modifier : un endpoint créé par une autre application du même espace de travail reste visible en GET mais renvoie 403 ici. Les endpoints créés depuis l'interface web Scribee n'appartiennent à aucune application et se gèrent uniquement depuis l'interface web - ils renvoient 403 pour toute application OAuth, quelle que soit celle qui appelle.

Request

Responses

200

L'endpoint webhook a été mis à jour et est retourné avec ses nouvelles valeurs d'attributs. event_type est immuable : s'il est présent dans le corps de la requête, il est silencieusement ignoré.

401

La requête ne comporte pas de jeton d'accès (bearer token), ou celui-ci est invalide ou expiré.

403

Le jeton de l'application OAuth est valide, mais l'application ne dispose d'aucune autorisation d'accès pour l'espace de travail demandé, ou un tel espace de travail n'existe pas.

404

Aucun endpoint webhook ne porte cet identifiant dans cet espace de travail.

422

Le payload webhook_endpoint a échoué la validation - url doit utiliser https, et category_id ne peut être renseigné que sur un type d'événement que la répartition sait router par catégorie. La règle sur includes diffère ici de celle appliquée à la création - elle n'est vérifiée que si vous envoyez une valeur différente, si bien qu'un endpoint qui stocke déjà un include que son type d'événement n'autorise plus continue de se mettre à jour, et vider includes passe toujours. Ce qui est refusé, c'est d'en envoyer un nouveau. Le corps de la réponse liste chaque attribut invalide et son motif sous errors.