---
title: "Delete one saved alert after the user requests removal. Requires its UUID and the latest config.version. Available without Access; other alerts remain unchanged."
method: DELETE
path: "/me/alerts/{alertId}"
---

# Delete one saved alert after the user requests removal. Requires its UUID and the latest config.version. Available without Access; other alerts remain unchanged.

`DELETE /me/alerts/{alertId}`

## Request

- Base URL: `https://api.hiddenjobs.dev/v1`
- URL: `https://api.hiddenjobs.dev/v1/me/alerts/{alertId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hiddenjobs.dev/v1/oauth/authorize`, token URL `https://api.hiddenjobs.dev/v1/oauth/token`, scopes: `email`)

## Path parameters

- `alertId` string, uuid, required

## Request body

- object
  - `expectedVersion` integer, required: Last config.version from get_job_alerts; use 0 before the first alert. Reread after a conflict.

## Response `200`

Operation result

- object
  - `data` object, required
    - `config` JobAlertConfig, required
      - `frequency` 'daily' | 'weekly', required
      - `enabled` boolean, required
      - `alerts` JobAlert[], required
        - `name` string, required
        - `frequency` 'daily' | 'weekly', required
        - `enabled` boolean, required
        - `category` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `employmentType` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `jobType` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `remoteLocation` string[], required: Match any selected value within this filter. All removes the filter; different filters combine with AND.
        - `id` string, uuid, required
        - `q` string, required
        - `since` string
        - `next_due_at` string
      - `version` integer, required
      - `next_due_at` string

## Other responses

- `400`: Invalid arguments
- `401`: Invalid credentials
- `403`: Permission denied
- `404`: Record not found
- `409`: Revision, idempotency or state conflict
- `413`: Size or quota limit
- `429`: Request limit
- `503`: Temporarily unavailable

---

[API](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api.md) · [All operations](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/revisions/c1d57d8e4720?raw)