---
title: "External Patch Alert"
method: PATCH
path: "/alerts/{alert_id}"
tags: ["alerts"]
---

# External Patch Alert

`PATCH /alerts/{alert_id}`

Partially update an existing alert by alert_id. `start_date` and `end_date` accept ISO 8601 date-time strings with `Z`, timezone offsets, or no timezone. Timezone-aware values are normalized to UTC and returned without timezone information.

## Path parameters

- `alert_id` integer, required

## Request body

- UpdateAlertSchema — Schema for partial updates of alerts (PATCH operations). All fields are optional - only provided fields will be updated.
  - `alert_name` string
  - `location_state` string
  - `location_city` string
  - `license_plate` string
  - `license_plate_state` string
  - `usdot_number` string
  - `chassis_number` string
  - `exact_match_chassis_number` boolean
  - `container_number` string
  - `equipment_type` string
  - `exact_match_container_number` boolean
  - `mc_number` string
  - `vin` string
  - `cab_number` string
  - `trailer_logo` string
  - `trailer_number` string
  - `disabled` boolean
  - `cc_emails` string[]
  - `alert_type` string
  - `exact_match_trailer_number` boolean
  - `start_date` string, date-time — ISO 8601 date-time. Values with `Z` or timezone offsets are normalized to UTC and stored/returned without timezone information.
  - `end_date` string, date-time — ISO 8601 date-time. Values with `Z` or timezone offsets are normalized to UTC and stored/returned without timezone information.
  - `deep_search` string
  - `notification_channels` string[]

## Response `200`

Successful Response

- AlertResponseSchema — Public API response schema for alerts - extends base with response-specific fields
  - `alert_name` string, required
  - `location_state` string
  - `location_city` string
  - `license_plate` string
  - `license_plate_state` string
  - `usdot_number` string
  - `chassis_number` string
  - `exact_match_chassis_number` boolean
  - `container_number` string
  - `equipment_type` string
  - `exact_match_container_number` boolean
  - `mc_number` string
  - `vin` string
  - `cab_number` string
  - `trailer_logo` string
  - `trailer_number` string
  - `disabled` boolean
  - `cc_emails` string[]
  - `alert_type` string
  - `exact_match_trailer_number` boolean
  - `start_date` string, date-time — Returned as a timezone-free UTC date-time string after normalization.
  - `end_date` string, date-time — Returned as a timezone-free UTC date-time string after normalization.
  - `deep_search` string
  - `id` integer, required
  - `email` string, required
  - `last_updated_timestamp` string, date-time, required
  - `insert_timestamp` string, date-time, required
  - `notification_channels` string[]

## Other responses

- `400` — Validation Error

---

[API](https://skmtc.dev/genlogs/apis/auth-api-create-token.md) · [All operations](https://skmtc.dev/genlogs/apis/auth-api-create-token/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/genlogs/auth-api-create-token/revisions/bf34c2431a21/schema)