---
title: "List your semantic alerts"
method: GET
path: "/me/semantic-alerts"
tags: ["Account"]
---

# List your semantic alerts

`GET /me/semantic-alerts`

Signed-in semantic alerts (#2304). Stores a freeform interest and email/webhook preferences. Matching runs after release.created for releases already on the caller's follow graph: one JEV decision per release, one question per enabled alert, notify when the matches-interest probability is at least the alert threshold (default 0.80, allowed 0.50–1.00). At most 5 alerts per account. Query text is user-private and is never written to Analytics Engine. Requires a Better Auth session or a user Bearer token (`relu_` or OAuth JWT); machine `relk_` tokens and anonymous callers are refused. Returns 404 when `semantic-alerts-enabled` is off.

## Response `200`

The caller's alerts, each with recent claimed-match activity. Empty when none are saved.

- object
  - `alerts` object[], required
    - `id` string, required — Typed id, `sal_` prefix.
    - `query` string, required — Freeform interest. User-private.
    - `enabled` boolean, required
    - `threshold` number, required
    - `deliverEmail` boolean, required
    - `deliverWebhook` boolean, required
    - `webhookSubscriptionId` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `activity` object, required — Claimed matches only (rows written when the alert notified). Below-threshold scores are not stored. Omitted on create, update, and single-get.
      - `matches7d` integer, required
      - `matches30d` integer, required
      - `lastMatchedAt` string, date-time, nullable, required
      - `lastMatch` object, nullable, required
        - `releaseId` string, required
        - `title` string, required
        - `path` string, required — Canonical site path, `/release/rel_…`.
  - `candidatePool` 'follows', required
  - `maxAlerts` integer, required

## Other responses

- `401` — Sign-in required
- `404` — Semantic alerts are disabled

## Changes

- **2026-09-23** `5d21ba2f0fcc` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/releases/apis/releases-api/changes/me/semantic-alerts/get.md)

---

[API](https://skmtc.dev/releases/apis/releases-api.md) · [All operations](https://skmtc.dev/releases/apis/releases-api/llms.txt) · [OpenAPI document](https://skmtc.dev/releases/apis/releases-api/revisions/099eb92e3137?raw)