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

# Events

Cedana API for events

## GET /v1/events

> Recent checkpoint and restore results, newest first (the UI notification feed)

```json
{"openapi":"3.1.0","info":{"title":"Cedana API","version":"0.0.0-dev"},"tags":[{"description":"Cedana API for events","name":"Events"}],"security":[{"Token":[]}],"components":{"securitySchemes":{"Token":{"scheme":"bearer","type":"http"}},"schemas":{"EventsResponse":{"properties":{"events":{"items":{"$ref":"#/components/schemas/NotificationEvent"},"type":"array"}},"required":["events"],"type":"object"},"NotificationEvent":{"properties":{"action_id":{"type":"string"},"checkpoint_id":{"type":"string"},"cluster_id":{"type":"string"},"context":{"type":"string"},"description":{"type":"string"},"duration_ns":{"format":"int64","minimum":0,"type":"integer"},"failure_reason":{"type":"string"},"failure_stage":{"type":"string"},"id":{"type":"string"},"name":{"type":"string"},"namespace":{"type":"string"},"node_name":{"type":"string"},"operation":{"type":"string"},"pause_ns":{"description":"Checkpoints: time the workload was held (see facts::checkpoint_pause_ns).","format":"int64","minimum":0,"type":"integer"},"physical_bytes":{"format":"int64","minimum":0,"type":"integer"},"pod_ready_at_ms":{"format":"int64","type":["integer","null"]},"pod_scheduled_at_ms":{"description":"Restores: PodScheduled / Ready transitions of the restored pod, once known.","format":"int64","type":["integer","null"]},"pod_uid":{"type":"string"},"read":{"type":"boolean"},"restore_uuid":{"type":"string"},"result":{"type":"string"},"storage_tier":{"type":"string"},"timestamp":{"type":"string"},"type":{"type":"string"},"workload_type":{"type":"string"}},"required":["id","timestamp","type","operation","result","description","context","read","cluster_id","workload_type","node_name","pod_uid","name","namespace","action_id","checkpoint_id","restore_uuid","storage_tier","failure_stage","failure_reason","duration_ns","physical_bytes","pause_ns"],"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/events":{"get":{"operationId":"list_events","parameters":[{"description":"Time window in seconds (default: 3600)","in":"query","name":"time","required":false,"schema":{"format":"int32","type":"integer"}},{"description":"Time window in hours; takes precedence over `time`","in":"query","name":"hrs","required":false,"schema":{"format":"int32","type":["integer","null"]}},{"description":"Filter by operation: checkpoint or restore","in":"query","name":"operation","required":false,"schema":{"type":["string","null"]}},{"description":"Filter by workload: kubernetes or slurm","in":"query","name":"workload","required":false,"schema":{"type":["string","null"]}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsResponse"}}},"description":"Recent operation results"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HttpError"}}},"description":"ClickHouse unavailable"},"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":"Recent checkpoint and restore results, newest first (the UI notification feed)","tags":["Events"]}}}}
```