Events

List events for a job

get

Returns the events for a job.

Path parameters

job_external_idstringRequired

Job external ID

Responses

200

Events

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

500

Internal Server Error

application/json

get/api/jobs/{job_external_id}/events

HTTPcURLJavaScriptPython

GET /api/jobs/{job_external_id}/events HTTP/1.1
Accept: */*

{
  "data": [
    {
      "id": 1,
      "job_id": 1,
      "message": "Job processing started",
      "type": "job_started"
    }
  ]
}

Create an event for a job

post

Creates an event for a job.

Path parameters

job_external_idstringRequired

Job external ID

Body

application/json

Responses

201

Created

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/api/jobs/{job_external_id}/events

HTTPcURLJavaScriptPython

POST /api/jobs/{job_external_id}/events HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "event": {
    "message": "Job processing started",
    "metadata": {},
    "type": "job_started"
  }
}

{
  "data": {
    "id": 1,
    "inserted_at": "2026-05-12T10:00:00Z",
    "job_id": 1,
    "message": "Job processing started",
    "metadata": {
      "key": "value"
    },
    "type": "job_started",
    "updated_at": "2026-05-12T10:00:00Z"
  }
}