Events · Kaarten

card.updated

Kaart bijgewerkt

Velden of inhoud van een kaart zijn gewijzigd: een wijziging in de stamgegevens van de kaart, tags, eigenaar, een nieuwe versie van het bestand of de tekst, een concept dat als nieuwe versie is gepubliceerd, of dat de verwerking de kaart haar toegangscategorie heeft toegekend (data.previous_attributes.category _unclassified – de kaart wachtte op classificatie en is nu beschikbaar voor ontvangers van wie het dataprofiel toegang geeft tot de categorie van de kaart). data.previous_attributes bevat de vorige waarden van de gewijzigde velden.

Objecttype: card
Geleverd aan: Webhooks die het object mogen zien: op basis van rol, dataprofiel en collecties

Payload

Object: EventCardUpdated

idstringverplicht
ID van het event (evt_…), ook meegestuurd als header webhook-id. Gebruik die om dubbele leveringen te negeren.
typestringverplicht
Toegestane waarden: card.updated
created_atstring (date-time)verplicht
Wanneer de wijziging plaatsvond (UTC).
org_idintegerverplicht
api_versionstringverplicht
Contractversie van het schema van data.
sequenceinteger
Volgnummer van de levering binnen de webhook (ontbreekt bij een testevent).
objectWebhookEventObjectverplicht
payloadstringverplicht
thin betekent geen data: lees het object via de API.
Toegestane waarden: fullthin
dataobject
Velden
- cardEventCardverplicht
- actor_idinteger | nullverplicht
  De gebruiker die de actie heeft uitgevoerd; null bij een API-sleutel van de organisatie of het platform zelf.
- previous_attributesobjectverplicht
  Vorige waarden van de gewijzigde velden op het hoogste niveau van het object.
- job_idinteger | null
  De indexerings- of exportjob.
- verified_on_publishboolean
  Het concept is als geverifieerd gepubliceerd.
testbooleanverplicht
Een testevent, verstuurd door POST /v1/webhooks/{webhook_id}/test.

Voorbeeldlevering

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "card.updated",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "card",
    "id": "c_9f2e41"
  },
  "payload": "full",
  "data": {
    "card": {
      "id": "c_9f2e41",
      "title": "Refund policy",
      "collection": "support",
      "collection_id": 3,
      "version": 4,
      "kind": "text",
      "status": "ready",
      "verification_state": "trusted",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "actor_id": 7,
    "previous_attributes": {
      "title": "Refunds"
    }
  },
  "test": false
}

Events ontvangen

Elke levering is een POST-request met deze JSON-body naar het ontvangstadres van je webhook. Controleer de header webhook-signature (Standard Webhooks) voordat je de body vertrouwt, antwoord binnen een paar seconden met een 2xx-status en doe het werk daarna. Leveringen aan één webhook behouden de volgorde van de events; een mislukte levering wordt met steeds langere pauzes opnieuw geprobeerd.

Er kunnen op elk moment nieuwe eventtypes en nieuwe velden bij komen: sla de types en velden over die je niet kent.

Dezelfde events staan 30 dagen in de eventfeed →