Eventi · Schede

card.updated

Scheda aggiornata

Sono cambiati i campi o il contenuto di una scheda: una modifica dei dati identificativi, i tag, il responsabile, una nuova versione del file o del testo, una bozza pubblicata come nuova versione, oppure l’elaborazione ha assegnato alla scheda la sua categoria di accesso (se data.previous_attributes.category è _unclassified, la scheda era in attesa di classificazione e ora è disponibile per i destinatari il cui profilo dati dà accesso a quella categoria). data.previous_attributes contiene i valori precedenti dei campi modificati.

Tipo di oggetto: card
Consegnato a: Webhook che possono vedere l’oggetto: in base a ruolo, profilo dati e raccolte

Payload dell’evento

Oggetto: EventCardUpdated

idstringobbligatorio
ID dell’evento (evt_…), inviato anche come intestazione webhook-id. Usalo per scartare le consegne duplicate.
typestringobbligatorio
Valori ammessi: card.updated
created_atstring (date-time)obbligatorio
Momento in cui è avvenuta la modifica (UTC).
org_idintegerobbligatorio
api_versionstringobbligatorio
Versione del contratto dello schema di data.
sequenceinteger
Numero progressivo della consegna all’interno del webhook (assente per un evento di test).
objectWebhookEventObjectobbligatorio
payloadstringobbligatorio
thin indica che non c’è data: leggi l’oggetto tramite l’API.
Valori ammessi: fullthin
dataobject
Campi
- cardEventCardobbligatorio
- actor_idinteger | nullobbligatorio
  L’utente che ha eseguito l’azione; null per una chiave API dell’organizzazione o per la piattaforma stessa.
- previous_attributesobjectobbligatorio
  Valori precedenti dei campi di primo livello modificati dell’oggetto.
- job_idinteger | null
  Il job di indicizzazione o di esportazione.
- verified_on_publishboolean
  La bozza è stata pubblicata come verificata.
testbooleanobbligatorio
Un evento di test inviato da POST /v1/webhooks/{webhook_id}/test.

Esempio di consegna

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

Ricezione degli eventi

Ogni consegna è una richiesta POST con questo corpo JSON verso il tuo webhook. Verifica l’intestazione webhook-signature (Standard Webhooks) prima di fidarti del corpo, rispondi con uno stato 2xx entro pochi secondi ed esegui il lavoro dopo. Le consegne a uno stesso webhook mantengono l’ordine degli eventi; una consegna non riuscita viene ritentata con pause sempre più lunghe.

Nuovi tipi di evento e nuovi campi possono comparire in qualsiasi momento: ignora i tipi e i campi che non conosci.

Gli stessi eventi restano nel feed degli eventi per 30 giorni →