How do I generate Alerts through API?

[DuckY-Y]

Hey,
I am probably missing something but basically I want to generate generate Points Of Interest to review later, for this I send a request to the server to create a event under the camera that I want with the label POI and a 10sec duration. That way I could then later on easily look up my generated snippets of the recording in the review tab under Alerts.
I however cannot see this even anywhere other than with the GET api.
Here's my config:

mqtt:
  enabled: false

tls:
  enabled: false

cameras:
  Loods-1:
    enabled: true
    ffmpeg:
      inputs:
        - path: 
            rtsp://frigate:[email protected]:554/Streaming/channels/102
          roles:
            - record
            - detect
    review:
      detections:
        labels:
          - POI

    motion:
      threshold: 46
      contour_area: 10
      improve_contrast: true
      mask:
        - 0.335,0.065,0.029,0.067,0.027,0.016,0.332,0.013
        - 0.336,0,0.357,1,0,1,0,0
detect:
  enabled: false

review:
  alerts:
    enabled: true
    labels:
      - POI

record:
  enabled: true
  retain:
    days: 1
  alerts:
    retain:
      days: 30
  detections:
    retain:
      days: 30

snapshots:
  enabled: true
  retain:
    default: 30

version: 0.16-0

I think I'm just missing something really simple..

[NickM-27]

You use the create event API https://docs.frigate.video/integrations/api/create-event-events-camera-name-label-create-post

[DuckY-Y]

Sorry should've pasted it instead of writing it out but here's the request I've been using:

curl -L 'https://frigate.12345.123/api/events/Loods-1/POI/create' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
  "source_type": "woop",
  "sub_label": "string",
  "score": 0,
  "duration": 10,
  "include_recording": true,
  "draw": {}
}'

[NickM-27]

You should not be setting source type

[DuckY-Y]

Ahhhh, yep thanks.
Removed the "source_type": "woop", "sub_label": "string",
That did the job.

[inkeep-ai-assistant[bot]]

---

The issue is that creating a manual event does not automatically trigger an update to the review interface(1). Manual events created via API won't appear in the review tab the same way tracked objects do.

To create a manual event that will be retained according to your alert retention settings, use the POST endpoint:

POST /events/{camera_name}/{label}/create

(2)

With a request body like:

{
  "duration": 10,
  "include_recording": true
}

(2)

However, creating a manual event does not trigger an update to /events MQTT topic(2), and similarly, these events don't automatically populate in the review interface as alerts would from actual detections.

Your configuration looks correct - you have POI listed under both review.alerts.labels and review.detections.labels(3). The events are being created (you can see them via GET API), but manual events created through the API don't integrate with the review system the same way as events from actual object detection.

The review system is designed primarily for events generated by Frigate's detection pipeline, not manual API-created events. While your manual events will be retained according to your retention policies, they won't appear in the review tab as expected.

**

📚 Sources:

1. Generative AI
2. POST /events/{camera_name}/{label}/create
3. Full Reference Config

---

Have another question? Just tag @inkeep.