PUTMéthode PUT/partner/webhooks/{webhook_id}

Vous modifiez un abonnement aux notifications que votre marque possède déjà, et vous recevez l'abonnement dans son nouvel état.

#Autorisation

Envoyez votre clef d'API dans l'en-tête Authorization, au format Bearer suivi d'un espace puis de la clef. La clef doit porter le droit webhooks:write. Une clef qui ne porte pas ce droit reçoit un 403 dont le message nomme le droit manquant.

Deux conditions s'ajoutent au droit de la clef.

• L'abonnement doit appartenir à la marque de la clef. Nous cherchons l'abonnement par son numéro et par votre marque. Quand cette recherche ne trouve rien, vous recevez un 404. Un abonnement qui appartient à une autre marque donne exactement la même réponse. Cette route ne vous apprend donc jamais qu'un numéro existe ailleurs.
• L'offre de votre marque doit comprendre les notifications. Sinon vous recevez un 403 portant le code FEATURE_NOT_AVAILABLE. Une exception existe, décrite juste en dessous.

L'adresse complète de ce point d'entrée est https://api.sealtrust.io/v1/partner/webhooks/{webhook_id}. Le même point d'entrée répond aussi sans le préfixe /v1, à https://api.sealtrust.io/partner/webhooks/{webhook_id}. Les deux adresses appellent le même code. Utilisez la forme /v1 pour une nouvelle intégration.

#Plafond d'appels

Nous mesurons le débit sur une fenêtre fixe de 60 secondes. Le plafond monte avec votre offre, et nous pouvons poser une valeur sur votre marque qui gagne sur celle de votre offre. Nous lisons donc, dans cet ordre : la valeur posée sur votre marque, puis celle de votre offre, puis une valeur de repli de 120 appels par fenêtre. Cette valeur de repli ne sert que si votre marque et votre offre n'en portent aucune.

Ne devinez pas votre plafond du moment. Vous le lisez sur chaque réponse qui franchit le contrôle de débit.

Deux compteurs se superposent, avec le même plafond : un par clef, un pour la somme de toutes les clefs de votre marque. Créer des clefs supplémentaires n'augmente donc pas le débit total autorisé.

Quatre en-têtes décrivent le compteur le plus contraignant des deux.

Un refus de débit renvoie 429 avec Retry-After, exprimé en secondes restantes dans la fenêtre en cours. Cette valeur n'est jamais inférieure à 1.

Ce point d'entrée ne consomme aucun quota quotidien de clef et aucun quota mensuel d'offre. Le plafond de débit est le seul compteur qui s'applique ici.

#Paramètres de chemin et de requête

Ce point d'entrée n'a aucun paramètre de requête.

#En-têtes

#Corps de la requête

Le corps est un objet JSON. Les quatre champs sont facultatifs. Envoyez uniquement les champs que vous voulez changer. Un champ absent du corps garde sa valeur.

Le serveur refuse tout champ que ce tableau ne nomme pas. Un champ inconnu fait échouer la requête en 422, et nous ne modifions rien.

Un corps vide, écrit {}, est valide. Il ne modifie rien, il renvoie l'abonnement inchangé, et nous exigeons l'offre comme pour n'importe quelle autre modification.

#Les 23 types d'événements

Une valeur de events qui n'est pas dans cette liste fait échouer la requête en 422, et le message nomme les valeurs refusées.

curl -i -X PUT https://api.sealtrust.io/v1/partner/webhooks/128 \
  -H "Authorization: Bearer st_test_0000000000000000000000000000000000000000000000" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://exemple-sas.example.com/sealtrust/evenements",
    "events": ["product.minted", "batch.completed"]
  }'

import { SealTrustClient } from "@sealtrust-io/sdk";

const sealtrust = new SealTrustClient({
  apiKey: "st_test_0000000000000000000000000000000000000000000000",
});

const abonnement = await sealtrust.webhooks.update(128, {
  url: "https://exemple-sas.example.com/sealtrust/evenements",
  events: ["product.minted", "batch.completed"],
});

console.log(abonnement.id, abonnement.url, abonnement.events);

import requests

response = requests.put(
    "https://api.sealtrust.io/v1/partner/webhooks/128",
    headers={
        "Authorization": "Bearer st_test_0000000000000000000000000000000000000000000000",
    },
    json={
        "url": "https://exemple-sas.example.com/sealtrust/evenements",
        "events": ["product.minted", "batch.completed"],
    },
    timeout=30,
)

print(response.status_code)
print(response.headers.get("X-RateLimit-Remaining"))
print(response.json())

{
  "id": 128,
  "brand_id": 12,
  "url": "https://exemple-sas.example.com/sealtrust/evenements",
  "events": ["product.minted", "batch.completed"],
  "is_active": true,
  "health": "healthy",
  "created_at": "2026-08-18T09:12:44.512038+00:00",
  "updated_at": "2026-08-20T14:03:21.884517+00:00"
}