For the complete documentation index, see llms.txt. This page is also available as Markdown.

Events (Slurm)

Cedana API for events (Slurm)

List job events

get

Derives an event stream from slurm_jobs rows in terminal states (PREEMPTED, NODE_FAIL, OOM, TIMEOUT, etc). Powered by data already arriving via /slurm/jobs/sync — no separate ingestion path.

Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
statusstring · nullableOptional

Filter by status (e.g. "PREEMPTED"). If omitted, returns all event statuses.

sinceinteger · nullableOptional

Only events at or after this epoch timestamp.

offsetinteger · int64Optional
limitinteger · int64Optional
Responses
200

Returns events

application/json
derived_ecinteger · nullableOptional
exit_codeinteger · nullableOptional
failed_nodestring · nullableOptional

Node that triggered the failure, if any.

job_idinteger · int64Required
kill_requidinteger · nullableOptional
partitionstring · nullableOptional
reasonstring · nullableOptional

Human-readable exit reason from slurmdbd (derived_es).

statusstringRequired
time_suspendedinteger · nullableOptional

Seconds the job spent suspended (preemption-with-checkpoint signal).

timestampinteger · int64Required

Epoch seconds; falls back to start_time, then submit_time, then 0.

get/v1/slurm/events
GET /v1/slurm/events HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
  {
    "derived_ec": null,
    "exit_code": null,
    "failed_node": null,
    "job_id": 1,
    "kill_requid": null,
    "partition": null,
    "reason": null,
    "status": "text",
    "time_suspended": null,
    "timestamp": 1
  }
]

Last updated

Was this helpful?