---
title: "Update a monitoring alert"
method: PATCH
path: "/monitoring/alerts/{alert_id}"
tags: ["Monitoring"]
---

# Update a monitoring alert

`PATCH /monitoring/alerts/{alert_id}`

## Path parameters

- `alert_id` string, uuid, required

## Request body

- MonitoringAlert
  - `business_id` string, uuid — Unique ID for the business. Exactly one of `business_id` or `person_id` must be set.
  - `creation_time` string, date-time — The date and time the resource was created.
  - `id` string, uuid — Unique identifier for this alert.
  - `last_updated_time` string, date-time — The date and time the resource was last update.
  - `metadata` Metadata — Optional field to store additional information about the resource. Intended to be used by the integrator to store non-sensitive data.
  - `monitoring_event_id` string, uuid — Unique identifier for the monitoring event that produced this alert.
  - `person_id` string, uuid — Unique ID for the person. Exactly one of `person_id` or `business_id` must be set.
  - `status` 'ACTIVE' | 'SUPPRESSED' — The status of the alert. Any of the following: * `ACTIVE` – alert has been issued and should be investigated. * `SUPPRESSED` – alert is a false positive, alert should be dismissed, or has been otherwise investigated.
  - `title` string — A description of the monitoring alert.
  - `type` 'BANKRUPTCY' | 'LICENSE_VALIDITY' | 'NEGATIVE_NEWS' | 'WATCHLIST' — The type of customer alert. Any of the following: * `WATCHLIST` – the customer was added to a known watchlist. * `BANKRUPTCY` – the customer filed for bankruptcy. * `NEGATIVE_NEWS` – the customer was mentioned in negative news articles. * `LICENSE_VALIDITY` – the license is no longer valid. Exmaple of this would be if a license was suspended
  - `urls` string[] — Where to get more information about this alert.
  - `vendor_info` union — The information provided to Synctera from the vendor. Interpretation of this object is up to the client.
    - object
      - `content_type` 'application/json', required — Describes the content-type encoding received from the vendor
      - `json` object, required — Data representation in JSON
      - `vendor` string, required
    - object
      - `content_type` 'text/xml', required — Describes the content-type encoding received from the vendor
      - `vendor` string, required
      - `xml` string, required — Data representaion in XML

## Response `200`

Updated monitoring alert.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `404` — Resource not found
- `500` — Internal server error

---

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