card.updated

Karte aktualisiert

Felder oder Inhalt der Karte haben sich geändert: eine Änderung am Steckbrief, Tags, die verantwortliche Person, eine neue Version der Datei oder des Textes, ein als neue Version veröffentlichter Entwurf oder die Zuweisung der Zugriffskategorie an die Karte durch die Verarbeitung (data.previous_attributes.category _unclassified – die Karte wartete auf die Klassifizierung und ist jetzt für Empfänger verfügbar, deren Datenprofil ihre Kategorie freigibt). data.previous_attributes enthält die vorherigen Werte der geänderten Felder.

Objekttyp: card
Zugestellt an: Endpunkte, die das Objekt sehen können: nach Rolle, Datenprofil und Sammlungen

Payload

Objekt: EventCardUpdated

idstringerforderlich
Ereignis-ID (evt_…), auch als Header webhook-id gesendet. Verwenden Sie sie, um doppelte Zustellungen zu verwerfen.
typestringerforderlich
Zulässige Werte: card.updated
created_atstring (date-time)erforderlich
Wann die Änderung stattgefunden hat (UTC).
org_idintegererforderlich
api_versionstringerforderlich
Vertragsversion des Schemas von data.
sequenceinteger
Laufende Nummer der Zustellung innerhalb des Endpunkts (fehlt bei einem Testereignis).
objectWebhookEventObjecterforderlich
payloadstringerforderlich
thin bedeutet kein data: Lesen Sie das Objekt über die API.
Zulässige Werte: fullthin
dataobject
Felder
- cardEventCarderforderlich
- actor_idinteger | nullerforderlich
  Der Benutzer, der die Aktion ausgeführt hat; null bei einem API-Schlüssel der Organisation oder der Plattform selbst.
- previous_attributesobjecterforderlich
  Vorherige Werte der geänderten Felder der obersten Ebene des Objekts.
- job_idinteger | null
  Der Indexierungs- oder Exportjob.
- verified_on_publishboolean
  Der Entwurf wurde als geprüft veröffentlicht.
testbooleanerforderlich
Ein Testereignis, gesendet durch POST /v1/webhooks/{webhook_id}/test.

Beispielzustellung

{
  "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
}

Ereignisse empfangen

Jede Zustellung ist eine POST-Anfrage mit diesem JSON-Body an Ihren Endpunkt. Prüfen Sie den Header webhook-signature (Standard Webhooks), bevor Sie dem Body vertrauen, antworten Sie innerhalb weniger Sekunden mit einem Status 2xx und erledigen Sie die Arbeit danach. Zustellungen an einen Endpunkt behalten die Reihenfolge der Ereignisse bei; eine fehlgeschlagene Zustellung wird mit wachsenden Pausen wiederholt.

Neue Ereignistypen und neue Felder können jederzeit hinzukommen: Überspringen Sie Typen und Felder, die Sie nicht kennen.

Dieselben Ereignisse stehen 30 Tage lang im Ereignis-Feed →