Reference

Get all events

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1 · max: 100Optional

Maximum number of events to return.

Default: 10Example: 20

camerasstring[]Optional

Comma-separated list of camera entity_ids.

Example: ["camera.front_door","camera.driveway"]

categoriesstring[]Optional

Comma-separated list of categories.

Example: ["person","package"]

daysintegerOptional

Time window [now - days, now].

Example: 2

Responses

200

Successful response

application/json

get

/events

Example request

curl -H "Authorization: Bearer $TOKEN" \
  "https://homeassistant.local:8123/api/llmvision/timeline/events?limit=20&cameras=camera.front_door,camera.driveway&categories=person,package&days=2"

200

Successful response

{
  "events": [
    {
      "uid": "f2a82dcd-f37b-459a-afdf-3a115631ed69",
      "title": "Delivery person seen",
      "start": "2025-10-24T09:04:51.433879+02:00",
      "end": "2025-10-24T09:05:51.433879+02:00",
      "description": "A delivery person approaches the front door.",
      "key_frame": "/media/llmvision/snapshots/37ddf64a-0.jpg",
      "camera_name": "camera.front_door",
      "category": "person",
      "label": "person"
    }
  ]
}

Get a single event

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

event_idstring · uuidRequired

Responses

200

Event found

application/json

404

Event not found

get

/event/{event_id}

HTTPcURLJavaScriptPython

GET /api/llmvision/timeline/event/{event_id} HTTP/1.1
Host: homeassistant.local:8123
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "event": {
    "uid": "f2a82dcd-f37b-459a-afdf-3a115631ed69",
    "title": "Delivery person seen",
    "start": "2025-10-24T09:04:51.433879+02:00",
    "end": "2025-10-24T09:05:51.433879+02:00",
    "description": "A delivery person approaches the front door.",
    "key_frame": "/media/llmvision/snapshots/37ddf64a-0.jpg",
    "camera_name": "camera.front_door",
    "category": "person",
    "label": "person"
  }
}

Update an existing event

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

event_idstring · uuidRequired

Body

application/json

Responses

200

Event updated

application/json

Responseone of

or

400

Invalid request body

404

Event not found

500

Server error

post

/event/{event_id}

HTTPcURLJavaScriptPython

POST /api/llmvision/timeline/event/{event_id} HTTP/1.1
Host: homeassistant.local:8123
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 349

{
  "uid": "f2a82dcd-f37b-459a-afdf-3a115631ed69",
  "title": "Delivery person seen",
  "start": "2025-10-24T09:04:51.433879+02:00",
  "end": "2025-10-24T09:05:51.433879+02:00",
  "description": "A delivery person approaches the front door.",
  "key_frame": "/media/llmvision/snapshots/37ddf64a-0.jpg",
  "camera_name": "camera.front_door",
  "category": "person",
  "label": "person"
}

{
  "event": {
    "uid": "f2a82dcd-f37b-459a-afdf-3a115631ed69",
    "title": "Delivery person seen",
    "start": "2025-10-24T09:04:51.433879+02:00",
    "end": "2025-10-24T09:05:51.433879+02:00",
    "description": "A delivery person approaches the front door.",
    "key_frame": "/media/llmvision/snapshots/37ddf64a-0.jpg",
    "camera_name": "camera.front_door",
    "category": "person",
    "label": "person"
  }
}

Delete an event

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

event_idstring · uuidRequired

Responses

200

Event deleted

application/json

404

Event not found

500

Error deleting event

delete

/event/{event_id}

HTTPcURLJavaScriptPython

DELETE /api/llmvision/timeline/event/{event_id} HTTP/1.1
Host: homeassistant.local:8123
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "event_id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "deleted"
}

Create a new event

post

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

titlestringOptional

descriptionstringOptional

key_framestringOptional

camera_namestringOptional

labelstringOptional

startstringOptional

ISO 8601 string or Unix timestamp

endstringOptional

ISO 8601 string or Unix timestamp

Responses

200

Event created

application/json

400

Invalid JSON body

404

Settings config entry not found

500

Error creating event

post

/events/new

HTTPcURLJavaScriptPython

POST /api/llmvision/timeline/events/new HTTP/1.1
Host: homeassistant.local:8123
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 120

{
  "title": "text",
  "description": "text",
  "key_frame": "text",
  "camera_name": "text",
  "label": "text",
  "start": "text",
  "end": "text"
}

{
  "status": "created"
}