---
title: "This endpoint is used for updating the status of an alert."
method: POST
path: "/alerts/{id}/status"
tags: ["Monitoring and Alerting"]
---

# This endpoint is used for updating the status of an alert.

`POST /alerts/{id}/status`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/alerts/{id}/status`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/alerts/:id/status/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to update the status of an alert.

## Path parameters

- `id` string, byte, required

## Request body

- object: UpdateAlertStatusRequest is used to update the status of an alert.
  - `remark` string: A remark associated with status update.
  - `status` 'ALERT_STATUS_UNSPECIFIED' | 'ALERT_STATUS_OPEN' | 'ALERT_STATUS_ACKNOWLEDGED' | 'ALERT_STATUS_RESOLVED' | 'ALERT_STATUS_AUTO_RESOLVED' | 'ALERT_STATUS_DELETED': AlertStatus specifies status of an alert.

## Response `200`

A successful response.

- JumpcloudAlertsUpdateAlertStatusResponse: UpdateAlertStatusResponse is the response message to UpdateAlertStatusRequest.
  - `alert` JumpcloudAlertsAlert: Alert holds the details of an alert.
    - `acknowledgedAt` string, date-time: acknowledged_at is the time when alert was acknowledged.
    - `category` 'ALERT_CATEGORY_UNSPECIFIED' | 'ALERT_CATEGORY_DIRECTORY' | 'ALERT_CATEGORY_SYSTEM' | 'ALERT_CATEGORY_ADMIN' | 'ALERT_CATEGORY_ACCESS' | 'ALERT_CATEGORY_GENERAL' | 'ALERT_CATEGORY_CUSTOM': AlertCategory specifies the category of an alert.
    - `createdAt` string, date-time: created_at is the creation time of the first occurrence (as specified by the alert occurrence generator).
    - `description` string
    - `firstOccurredAt` string, date-time: first_occurred_at is the time of the first occurrence of the alert.
    - `frequency` integer
    - `lastOccurredAt` string, date-time: last_occurred_at is the time of the last occurrence of the alert.
    - `lastOccurrenceContext` object: context holds the context of of last alert occurrence.
    - `objectId` string, byte: id holds the unique identifier of an alert.
    - `occurrencesCount` integer: occurrences_count is the number of occurrences of the alert.
    - `organizationObjectId` string, byte
    - `referenceId` string
    - `remark` string: A remark added to the alert while updating.
    - `resolvedAt` string, date-time: resolved_at is the time when alert was resolved.
    - `severity` 'ALERT_SEVERITY_UNSPECIFIED' | 'ALERT_SEVERITY_LOW' | 'ALERT_SEVERITY_MEDIUM' | 'ALERT_SEVERITY_HIGH': AlertSeverity specifies the severity of an alert.
    - `sourceId` string
    - `sourceName` string
    - `sourceType` 'ALERT_SOURCE_TYPE_UNSPECIFIED' | 'ALERT_SOURCE_TYPE_USER' | 'ALERT_SOURCE_TYPE_ADMIN' | 'ALERT_SOURCE_TYPE_DEVICE' | 'ALERT_SOURCE_TYPE_USER_GROUP' | 'ALERT_SOURCE_TYPE_DEVICES' | 'ALERT_SOURCE_TYPE_ACCESS_REQUEST' | 'ALERT_SOURCE_TYPE_SAAS_APPLICATION' | 'ALERT_SOURCE_TYPE_CUSTOM' | 'ALERT_SOURCE_TYPE_COMMAND' | 'ALERT_SOURCE_TYPE_POLICY' | 'ALERT_SOURCE_TYPE_APPLICATION' | 'ALERT_SOURCE_TYPE_IPLIST' | 'ALERT_SOURCE_TYPE_SOFTWARE' | 'ALERT_SOURCE_TYPE_ACCESSORY' | 'ALERT_SOURCE_TYPE_LOCATION': AlertSourceType specifies the type of the source that generated the alert.
    - `status` 'ALERT_STATUS_UNSPECIFIED' | 'ALERT_STATUS_OPEN' | 'ALERT_STATUS_ACKNOWLEDGED' | 'ALERT_STATUS_RESOLVED' | 'ALERT_STATUS_AUTO_RESOLVED' | 'ALERT_STATUS_DELETED': AlertStatus specifies status of an alert.
    - `title` string
    - `updatedAt` string, date-time: updated_at is the time when alert was updated.

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)