card.updated

Zaktualizowano kartę

Zmieniły się pola lub treść karty: edycja metryczki, tagi, właściciel, nowa wersja pliku lub tekstu, szkic opublikowany jako nowa wersja albo kategoria dostępu nadana karcie w wyniku przetwarzania (data.previous_attributes.category _unclassified – karta czekała na klasyfikację i jest teraz dostępna dla odbiorców, których profil dostępu obejmuje jej kategorię). data.previous_attributes zawiera poprzednie wartości zmienionych pól.

Typ obiektu: card
Odbiorcy: Webhooki, które widzą obiekt: według roli, profilu dostępu i kolekcji

Treść zdarzenia

Obiekt: EventCardUpdated

idstringwymagane
ID zdarzenia (evt_…), wysyłany także jako nagłówek webhook-id. Używaj go do odrzucania zduplikowanych dostarczeń.
typestringwymagane
Dozwolone wartości: card.updated
created_atstring (date-time)wymagane
Kiedy nastąpiła zmiana (UTC).
org_idintegerwymagane
api_versionstringwymagane
Wersja kontraktu schematu data.
sequenceinteger
Numer kolejny dostarczenia w obrębie webhooka (brak dla zdarzenia testowego).
objectWebhookEventObjectwymagane
payloadstringwymagane
thin oznacza brak data: odczytaj obiekt przez API.
Dozwolone wartości: fullthin
dataobject
Pola
- cardEventCardwymagane
- actor_idinteger | nullwymagane
  Użytkownik, który wykonał działanie; null dla klucza API organizacji lub samej platformy.
- previous_attributesobjectwymagane
  Poprzednie wartości zmienionych pól najwyższego poziomu obiektu.
- job_idinteger | null
  Zadanie indeksowania lub eksportu.
- verified_on_publishboolean
  Szkic został opublikowany jako zweryfikowany.
testbooleanwymagane
Zdarzenie testowe wysłane przez POST /v1/webhooks/{webhook_id}/test.

Przykładowe dostarczenie

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

Odbieranie zdarzeń

Każde dostarczenie to żądanie POST z tą treścią JSON wysyłane na adres odbiorcy Twojego webhooka. Zanim zaufasz treści, zweryfikuj nagłówek webhook-signature (Standard Webhooks), odpowiedz statusem 2xx w ciągu kilku sekund, a właściwą pracę wykonaj później. Dostarczenia do jednego webhooka zachowują kolejność zdarzeń; nieudane dostarczenie jest ponawiane z coraz dłuższymi przerwami.

Nowe typy zdarzeń i nowe pola mogą pojawić się w każdej chwili: pomijaj typy i pola, których nie znasz.

Te same zdarzenia są dostępne w kanale zdarzeń przez 30 dni →