Aller au contenu
Sursa Developers

Événements · Collections et dossiers

collection.updated

Collection modifiée

Les réglages de la collection ont changé (data.previous_attributes contient les valeurs précédentes).

Type d’objet
collection
Livré à
Webhooks qui peuvent voir l’objet : selon le rôle, le profil de données et les collections

Charge utile

Objet : EventCollectionUpdated

  • idstringobligatoire

    ID de l’événement (evt_…), également envoyé dans l’en-tête webhook-id. Utilisez-le pour écarter les livraisons en double.

  • typestringobligatoire

    Valeurs autorisées: collection.updated

  • created_atstring (date-time)obligatoire

    Date de la modification (UTC).

  • org_idintegerobligatoire
  • api_versionstringobligatoire

    Version du contrat du schéma de data.

  • sequenceinteger

    Numéro de séquence de la livraison au sein du webhook (absent pour un événement de test).

  • objectWebhookEventObjectobligatoire
  • payloadstringobligatoire

    thin signifie sans data : lisez l’objet via l’API.

    Valeurs autorisées: fullthin

  • dataobject
    Champs
    • collectionEventCollectionobligatoire
    • actor_idinteger | nullobligatoire

      Utilisateur qui a effectué l’action ; null pour une clé API de l’organisation ou la plateforme elle-même.

    • previous_attributesobjectobligatoire

      Anciennes valeurs des champs de premier niveau modifiés de l’objet.

  • testbooleanobligatoire

    Événement de test envoyé par POST /v1/webhooks/{webhook_id}/test.

Exemple de livraison

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "collection.updated",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "collection",
    "id": "3"
  },
  "payload": "full",
  "data": {
    "collection": {
      "id": 3,
      "name": "support",
      "title": "Support",
      "description": "Answers for the support team",
      "metadata": {}
    },
    "actor_id": 7,
    "previous_attributes": {
      "title": "Help desk"
    }
  },
  "test": false
}

Recevoir les événements

Chaque livraison est une requête POST envoyée à votre webhook avec ce corps JSON. Vérifiez l’en-tête webhook-signature (Standard Webhooks) avant de vous fier au corps, répondez par un statut 2xx en quelques secondes et faites le traitement ensuite. Les livraisons vers un même webhook respectent l’ordre des événements ; une livraison en échec est relancée avec des pauses de plus en plus longues.

De nouveaux types d’événements et de nouveaux champs peuvent apparaître à tout moment : ignorez les types et les champs que vous ne connaissez pas.

Les mêmes événements restent 30 jours dans le flux d’événements →