> For the complete documentation index, see [llms.txt](https://docs.cedana.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cedana.ai/references/api/events-slurm.md).

# Events (Slurm)

Cedana API for events (Slurm)

## List job events

> 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.

```json
{"openapi":"3.1.0","info":{"title":"Cedana API","version":"0.0.0-dev"},"tags":[{"description":"Cedana API for events (Slurm)","name":"Events (Slurm)"}],"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"scheme":"bearer","type":"http"}},"schemas":{"SlurmEvent":{"properties":{"derived_ec":{"format":"int64","type":["integer","null"]},"exit_code":{"format":"int32","type":["integer","null"]},"failed_node":{"description":"Node that triggered the failure, if any.","type":["string","null"]},"job_id":{"format":"int64","type":"integer"},"kill_requid":{"format":"int64","type":["integer","null"]},"partition":{"type":["string","null"]},"reason":{"description":"Human-readable exit reason from slurmdbd (derived_es).","type":["string","null"]},"status":{"type":"string"},"time_suspended":{"description":"Seconds the job spent suspended (preemption-with-checkpoint signal).","format":"int64","type":["integer","null"]},"timestamp":{"description":"Epoch seconds; falls back to start_time, then submit_time, then 0.","format":"int64","type":"integer"}},"required":["job_id","status","timestamp"],"type":"object"},"HttpError":{"description":"Standard JSON error body for all 4xx/5xx responses.\n\nHandlers return plain-text errors internally; [`normalize_error_response`]\nconverts anything the stack produces (handlers, extractors, the auth layer)\nto this shape, so generated SDK clients can rely on a single error schema.","properties":{"message":{"description":"Human-readable description of what went wrong","type":"string"}},"required":["message"],"type":"object"}}},"paths":{"/v1/slurm/events":{"get":{"description":"Derives an event stream from `slurm_jobs` rows in terminal states\n(PREEMPTED, NODE_FAIL, OOM, TIMEOUT, etc). Powered by data already\narriving via `/slurm/jobs/sync` — no separate ingestion path.","operationId":"list","parameters":[{"description":"Filter by status (e.g. \"PREEMPTED\"). If omitted, returns all event statuses.","in":"query","name":"status","required":false,"schema":{"type":["string","null"]}},{"description":"Only events at or after this epoch timestamp.","in":"query","name":"since","required":false,"schema":{"format":"int64","type":["integer","null"]}},{"in":"query","name":"offset","required":false,"schema":{"format":"int64","type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"format":"int64","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SlurmEvent"},"type":"array"}}},"description":"Returns events"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpError"}}},"description":"Failed to fetch from database"},"4XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpError"}}},"description":"Client error"},"5XX":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpError"}}},"description":"Server error"}},"summary":"List job events","tags":["Events (Slurm)"]}}}}
```