card.updated

Karta aktualizována

Změnila se pole nebo obsah karty: úprava profilu karty, štítky, vlastník, nová verze souboru nebo textu, koncept publikovaný jako nová verze nebo kategorie přístupu, kterou kartě přiřadilo zpracování (data.previous_attributes.category _unclassified – karta čekala na klasifikaci a nyní je dostupná příjemcům, jejichž datový profil zpřístupňuje její kategorii). data.previous_attributes obsahuje předchozí hodnoty změněných polí.

Typ objektu: card
Komu se doručuje: Webhookům, které objekt vidí: podle role, datového profilu a kolekcí

Obsah události

Objekt: EventCardUpdated

idstringpovinné
ID události (evt_…), posílá se také jako hlavička webhook-id. Podle něj zahazujte duplicitní doručení.
typestringpovinné
Povolené hodnoty: card.updated
created_atstring (date-time)povinné
Kdy ke změně došlo (UTC).
org_idintegerpovinné
api_versionstringpovinné
Verze kontraktu schématu data.
sequenceinteger
Pořadové číslo doručení v rámci webhooku (u testovací události chybí).
objectWebhookEventObjectpovinné
payloadstringpovinné
thin znamená bez data: objekt si přečtěte přes API.
Povolené hodnoty: fullthin
dataobject
Pole
- cardEventCardpovinné
- actor_idinteger | nullpovinné
  Uživatel, který akci provedl; null u klíče API organizace nebo samotné platformy.
- previous_attributesobjectpovinné
  Předchozí hodnoty změněných polí nejvyšší úrovně objektu.
- job_idinteger | null
  Úloha indexování nebo exportu.
- verified_on_publishboolean
  Koncept byl publikován jako ověřený.
testbooleanpovinné
Testovací událost odeslaná pomocí POST /v1/webhooks/{webhook_id}/test.

Ukázka doručení

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

Příjem událostí

Každé doručení je požadavek POST s tímto tělem JSON na adresu vašeho příjemce. Než tělu začnete důvěřovat, ověřte hlavičku webhook-signature (Standard Webhooks), do několika sekund odpovězte stavovým kódem 2xx a samotnou práci udělejte až potom. Doručení na jeden webhook zachovávají pořadí událostí; neúspěšné doručení se opakuje s rostoucími pauzami.

Nové typy událostí a nová pole se mohou objevit kdykoli: typy a pole, které neznáte, přeskočte.

Stejné události najdete 30 dní v kanálu událostí →