Hændelser · Job og eksporter
job.failed
Job mislykkedes
Et baggrundsjob mislykkedes eller blev annulleret (data.reason er en neutral kode).
- Objekttype
- job
- Leveres til
- Slutpunkter med rollen admin
Payload
idstringpåkrævetHændelsens id (
evt_…), sendes også som headerenwebhook-id. Brug det til at frasortere dobbelte leveringer.typestringpåkrævetTilladte værdier:
job.failedcreated_atstring (date-time)påkrævetTidspunkt, hvor ændringen skete (UTC).
org_idintegerpåkrævetapi_versionstringpåkrævetKontraktversion for skemaet
data.sequenceintegerLeveringens løbenummer inden for slutpunktet (mangler for en testhændelse).
payloadstringpåkrævetthinbetyder ingendata: læs objektet via API’et.Tilladte værdier:
fullthindataobjectFelter
reasonstringpåkrævetNeutral årsagskode (udvidelig enum: behandl en ukendt kode som en generel fejl). Eksempler:
canceled,timeout,unprocessable,internal.
testbooleanpåkrævetEn testhændelse sendt af
POST /v1/webhooks/{webhook_id}/test.
Eksempel på levering
{
"id": "evt_0123456789abcdef0123456789abcdef",
"type": "job.failed",
"created_at": "2026-10-24T10:00:03Z",
"org_id": 1,
"api_version": "1.62.0",
"sequence": 1042,
"object": {
"type": "job",
"id": "4410"
},
"payload": "full",
"data": {
"job": {
"id": 4410,
"kind": "index",
"status": "error",
"card_id": "c_9f2e41",
"collection": "support",
"batch_id": null,
"title": "Refund policy.pdf",
"finished_at": "2026-10-24T10:00:03Z"
},
"reason": "timeout"
},
"test": false
}Modtag hændelser
Hver levering er en POST-anmodning med denne JSON-brødtekst til dit slutpunkt. Validér headeren webhook-signature (Standard Webhooks), før du stoler på brødteksten, svar med en 2xx-status inden for få sekunder, og udfør arbejdet bagefter. Leveringer til samme slutpunkt bevarer hændelsernes rækkefølge; en mislykket levering forsøges igen med stadig længere pauser.
Nye hændelsestyper og nye felter kan dukke op når som helst: Spring de typer og felter over, som du ikke kender.