Eventos · Tarjetas
card.index_failed
Indexación de la tarjeta fallida
Falló la indexación de una versión de la tarjeta (data.reason es un código neutro). La tarjeta conserva el estado de error hasta que se vuelve a subir o a reindexar.
- Tipo de objeto
- card
- Se entrega a
- Webhooks que pueden ver el objeto: según el rol, el perfil de datos y las colecciones
Carga útil
idstringobligatorioID del evento (
evt_…), que también se envía como encabezadowebhook-id. Úselo para descartar entregas duplicadas.typestringobligatorioValores permitidos:
card.index_failedcreated_atstring (date-time)obligatorioCuándo se produjo el cambio (UTC).
org_idintegerobligatorioapi_versionstringobligatorioVersión del contrato del esquema de
data.sequenceintegerNúmero de secuencia de la entrega dentro del webhook (no aparece en un evento de prueba).
payloadstringobligatoriothinsignifica sindata: lea el objeto a través de la API.Valores permitidos:
fullthindataobjectCampos
job_idinteger | nullEl trabajo de indexación o de exportación.
versionintegerobligatorioreasonstringobligatorioCódigo neutro del motivo (enumeración ampliable: trate un código desconocido como un fallo genérico). Ejemplos:
unprocessable,too_large,timeout,upstream_unavailable,internal.
testbooleanobligatorioUn evento de prueba enviado por
POST /v1/webhooks/{webhook_id}/test.
Ejemplo de entrega
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "card.index_failed",
"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": "error",
"verification_state": "trusted",
"owner_id": 7,
"tags": [
"billing"
],
"external_id": null,
"metadata": {}
},
"job_id": 4410,
"version": 4,
"reason": "unprocessable"
},
"test": false
}Recepción de eventos
Cada entrega es una solicitud POST con este cuerpo JSON a la URL de su webhook. Compruebe el encabezado webhook-signature (Standard Webhooks) antes de confiar en el cuerpo, responda con un estado 2xx en pocos segundos y haga el trabajo después. Las entregas a un mismo webhook conservan el orden de los eventos; una entrega fallida se reintenta con pausas cada vez más largas.
En cualquier momento pueden aparecer tipos de evento y campos nuevos: omita los tipos y campos que no conozca.
Los mismos eventos están en el feed de eventos durante 30 días →