Events

List events for a job

get

Returns the events associated with a job. If the job has no events, the response contains an empty list.

Requires the 'Execute structure profiling' permission. The check is global: the caller must hold the permission in at least one domain. Administrators and service accounts are always allowed.

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

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.

Requires administrative privileges (administrator or service account).

Request body:

• event (required) – Object containing:

  • type (required, string) – Event type.

  • message (required, string) – Event message.

  • metadata (optional, object) – Additional event metadata.

Path parameters

job_external_idstringRequired

Job external ID

Body

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

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