---
title: "Update a custom hotlist"
method: PUT
path: "/hotlists/{hotlistId}"
tags: ["Custom Hotlists"]
---

# Update a custom hotlist

`PUT /hotlists/{hotlistId}`

Update a hotlist

## Path parameters

- `hotlistId` string, uuid, required

## Request body

- UpdateHotlistRequest
  - `entries` CreateHotlistEntryRequest[], required
    - `caseNumber` string, required
    - `expiry` string, date-time — ISO datetime string. After this date, alerts will not be triggered for this entry.
    - `plate` string, required
    - `reason` string, required
    - `state` 'alabama' | 'alaska' | 'arizona' | 'arkansas' | 'california' | 'colorado' | 'connecticut' | 'delaware' | 'washington_dc' | 'florida' | 'georgia' | 'hawaii' | 'idaho' | 'illinois' | 'indiana' | 'iowa' | 'kansas' | 'kentucky' | 'louisiana' | 'maine' | 'maryland' | 'massachusetts' | 'michigan' | 'minnesota' | 'mississippi' | 'missouri' | 'montana' | 'nebraska' | 'nevada' | 'new_hampshire' | 'new_jersey' | 'new_mexico' | 'new_york' | 'north_carolina' | 'north_dakota' | 'ohio' | 'oklahoma' | 'oregon' | 'pennsylvania' | 'rhode_island' | 'south_carolina' | 'south_dakota' | 'tennessee' | 'texas' | 'utah' | 'vermont' | 'virginia' | 'washington' | 'west_virginia' | 'wisconsin' | 'wyoming' | 'puerto_rico'
    - `note` HotlistEntryNote — Optional note with message field for the hotlist entry
      - `message` string, required — Note message text (supports URLs for clickable links in UI)
  - `name` string, required

## Response `204`

The hotlist was updated successfully

## Other responses

- `401` — Unauthorized, authentication token was invalid or not provided
- `403` — Forbidden, your client does not have access to this resource
- `404` — No hotlist was found with the given ID
- `413` — Request entity too large, the number of entries exceeds the organization's limit

---

[API](https://skmtc.net/flocksafety/apis/oauth-api.md) · [All operations](https://skmtc.net/flocksafety/apis/oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flocksafety/oauth-api/versions/126df7964ba5/schema)