Skip to Content

job.failed

A job could not finish. data: The job as it finished, with error filled in.

Header Parameters

CharpstAR-Event*string
CharpstAR-Delivery*string

The delivery id; the same on every retry.

Formatuuid
CharpstAR-Signature*string

t=,v1=<hex HMAC SHA-256 of t + '.' + raw body, keyed with your whsec_ secret>

User-Agent*string

Request Body

application/json
  1. body
id*string

The delivery id; the same as the CharpstAR-Delivery header and the same on every retry.

Formatuuid
type*string
occurredAt*string

When it happened on our side.

Formatdate-time
client*

The company the key belongs to.

article*|

The article number the event is about, or null when the event is not about one product.

data*

Response Body

Any 2xx within 10 seconds means handled. Anything else is retried.

Example Requests
POST/job.failed
Request Body
application/json
{  "id": "3a4b5c6d-7e8f-4a9b-8c0d-1e2f3a4b5c6d",  "type": "job.failed",  "occurredAt": "2026-11-02T08:09:52.000Z",  "client": {    "id": "e2b7c1d4-5a6f-4b8c-9d0e-1f2a3b4c5d6e",    "name": "Your Company"  },  "article": "CH-1001",  "data": {    "id": "5c0e2f9a-7b14-4d3e-a8c1-93f6e2b7d045",    "type": "packshot",    "articleId": "CH-1001",    "variant": null,    "status": "failed",    "options": {      "views": [        "front",        "left",        "back"      ],      "background": "transparent",      "size": 4096,      "aspectRatio": "1:1",      "format": "png",      "shadows": true,      "lighting": "studio",      "preset": "Marketplace (GS1)"    },    "naming": {      "preset": "gs1"    },    "metadata": {      "purchaseOrder": "PO-88213"    },    "createdAt": "2026-11-02T08:00:00.000Z",    "startedAt": "2026-11-02T08:01:10.000Z",    "finishedAt": "2026-11-02T08:09:52.000Z",    "outputs": [],    "error": {      "code": "internal_error",      "message": "The pictures could not be made. Our team has been told; you can start the job again."    }  }}
Header Parameters
{  "CharpstAR-Event": "job.failed",  "CharpstAR-Delivery": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "CharpstAR-Signature": "string",  "User-Agent": "CharpstAR-Webhooks/1"}