card.updated

Entrada actualitzada

Han canviat camps o el contingut de l’entrada: una edició de la fitxa de l’entrada, les etiquetes, el responsable, una versió nova del fitxer o del text, un esborrany publicat com a versió nova, o el processament ha assignat a l’entrada la seva categoria d’accés (si data.previous_attributes.category és _unclassified, l’entrada estava pendent de classificació i ara està disponible per als destinataris el perfil de dades dels quals dona accés a aquesta categoria). data.previous_attributes conté els valors anteriors dels camps que han canviat.

Tipus d’objecte: card
Es lliura a: Webhooks que poden veure l’objecte: segons el rol, el perfil de dades i les col·leccions

Càrrega útil

Objecte: EventCardUpdated

idstringobligatori
ID de l’esdeveniment (evt_…), que també s’envia com a capçalera webhook-id. Feu-lo servir per descartar els lliuraments duplicats.
typestringobligatori
Valors permesos: card.updated
created_atstring (date-time)obligatori
Moment en què es va produir el canvi (UTC).
org_idintegerobligatori
api_versionstringobligatori
Versió del contracte de l’esquema de data.
sequenceinteger
Número de seqüència del lliurament dins del webhook (no hi és en un esdeveniment de prova).
objectWebhookEventObjectobligatori
payloadstringobligatori
thin vol dir sense data: llegiu l’objecte a través de l’API.
Valors permesos: fullthin
dataobject
Camps
- cardEventCardobligatori
- actor_idinteger | nullobligatori
  Usuari que ha fet l’acció; null per a una clau d’API de l’organització o la mateixa plataforma.
- previous_attributesobjectobligatori
  Valors anteriors dels camps de primer nivell de l’objecte que han canviat.
- job_idinteger | null
  Treball d’indexació o d’exportació.
- verified_on_publishboolean
  L’esborrany s’ha publicat com a verificat.
testbooleanobligatori
Esdeveniment de prova enviat per POST /v1/webhooks/{webhook_id}/test.

Exemple de lliurament

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

Recepció d’esdeveniments

Cada lliurament és una sol·licitud POST amb aquest cos JSON a l’URL del vostre webhook. Verifiqueu la capçalera webhook-signature (Standard Webhooks) abans de confiar en el cos, responeu amb un estat 2xx en pocs segons i feu la feina després. Els lliuraments a un mateix webhook mantenen l’ordre dels esdeveniments; un lliurament fallit es reintenta amb pauses cada vegada més llargues.

En qualsevol moment poden aparèixer tipus d’esdeveniment i camps nous: ometeu els tipus i els camps que no conegueu.

Els mateixos esdeveniments són al canal d’esdeveniments durant 30 dies →