---
title: "Get Alert"
method: POST
path: "/alert/{id}/get-item"
tags: ["Alert"]
---

# Get Alert

`POST /alert/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/alert/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/alert/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single Alert by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `select` AlertSelectSchema: Select schema for Alert. Set fields to true to include them in the response.
    - `_id` boolean
    - `createdAt` boolean
    - `updatedAt` boolean
    - `deletedAt` boolean
    - `projectId` boolean
    - `title` boolean
    - `description` boolean
    - `impactStartedAt` boolean
    - `firstPagedAt` boolean
    - `createdByUserId` boolean
    - `monitorId` boolean
    - `onCallDutyPolicies` OnCallDutyPolicyRelationSelectSchema: What a select may name of the OnCallDutyPolicy records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `repeatPolicyIfNoOneAcknowledgesNoOfTimes` boolean
    - `hosts` HostRelationSelectSchema: What a select may name of the Host records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `hostIdentifier` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `osType` boolean
      - `osVersion` boolean
      - `hostId` boolean
      - `hostArch` boolean
      - `hostType` boolean
      - `hostIpAddresses` boolean
      - `cpuCores` boolean
      - `totalMemoryBytes` boolean
      - `processCount` boolean
      - `containerRuntime` boolean
      - `deploymentEnvironment` boolean
      - `runtimeName` boolean
      - `runtimeVersion` boolean
      - `cloudProvider` boolean
      - `cloudPlatform` boolean
      - `cloudRegion` boolean
      - `cloudAccountId` boolean
      - `latestCpuPercent` boolean
      - `latestMemoryPercent` boolean
      - `latestSwapPercent` boolean
      - `latestDiskPercent` boolean
      - `latestDiskMountpoint` boolean
      - `latestInodesPercent` boolean
      - `latestInodesMountpoint` boolean
      - `latestLoadAverage15m` boolean
      - `bootedAt` boolean
      - `failedSystemdUnitCount` boolean
      - `failedSystemdUnits` boolean
      - `readingsUpdatedAt` boolean
    - `networkDevices` NetworkDeviceRelationSelectSchema: What a select may name of the NetworkDevice records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `hostname` boolean
      - `dnsName` boolean
      - `otherAddresses` boolean
      - `discoveredName` boolean
      - `discoveredNameSource` boolean
      - `macAddress` boolean
      - `isMacAddressLearned` boolean
      - `probeId` boolean
      - `siteId` boolean
      - `oidTemplateId` boolean
      - `snmpCredentialProfileId` boolean
      - `currentMonitorStatusId` boolean
      - `monitoringMethod` boolean
      - `deviceRole` boolean
      - `networkDeviceRoleId` boolean
      - `monitorId` boolean
      - `snmpVersion` boolean
      - `sysDescr` boolean
      - `sysName` boolean
      - `sysObjectId` boolean
      - `sysLocation` boolean
      - `vendor` boolean
      - `deviceModel` boolean
      - `lastRebootedAt` boolean
      - `lastSeenAt` boolean
      - `lastPolledAt` boolean
      - `isReachable` boolean
      - `isSnmpReachable` boolean
      - `lastSnmpSeenAt` boolean
    - `kubernetesClusters` KubernetesClusterRelationSelectSchema: What a select may name of the KubernetesCluster records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `clusterIdentifier` boolean
      - `provider` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `aiAccessRunnerId` boolean
    - `kubernetesResources` KubernetesResourceRelationSelectSchema: What a select may name of the KubernetesResource records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `kubernetesClusterId` boolean
      - `kind` boolean
      - `namespaceKey` boolean
      - `name` boolean
      - `uid` boolean
      - `phase` boolean
      - `isReady` boolean
      - `hasMemoryPressure` boolean
      - `hasDiskPressure` boolean
      - `hasPidPressure` boolean
      - `containerCount` boolean
      - `healthSeverity` boolean
      - `controllerDeploymentName` boolean
      - `controllerCronJobName` boolean
      - `latestCpuPercent` boolean
      - `latestMemoryBytes` boolean
      - `latestMemoryPercent` boolean
      - `metricsUpdatedAt` boolean
      - `lastSeenAt` boolean
      - `resourceCreationTimestamp` boolean
    - `kubernetesContainers` KubernetesContainerRelationSelectSchema: What a select may name of the KubernetesContainer records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `kubernetesClusterId` boolean
      - `podNamespaceKey` boolean
      - `podName` boolean
      - `name` boolean
      - `image` boolean
      - `state` boolean
      - `reason` boolean
      - `isReady` boolean
      - `restartCount` boolean
      - `memoryLimitBytes` boolean
      - `latestCpuPercent` boolean
      - `latestMemoryBytes` boolean
      - `metricsUpdatedAt` boolean
      - `lastSeenAt` boolean
    - `dockerHosts` DockerHostRelationSelectSchema: What a select may name of the DockerHost records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `hostIdentifier` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `osType` boolean
      - `osVersion` boolean
    - `podmanHosts` PodmanHostRelationSelectSchema: What a select may name of the PodmanHost records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `hostIdentifier` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `osType` boolean
      - `osVersion` boolean
    - `proxmoxClusters` ProxmoxClusterRelationSelectSchema: What a select may name of the ProxmoxCluster records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `pveVersion` boolean
      - `lastSeenAt` boolean
    - `openStackClouds` OpenStackCloudRelationSelectSchema: What a select may name of the OpenStackCloud records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `collectionMethod` boolean
    - `vmwareVCenters` VMwareVCenterRelationSelectSchema: What a select may name of the VMwareVCenter records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `collectionMethod` boolean
    - `iotFleets` IoTFleetRelationSelectSchema: What a select may name of the IoTFleet records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
    - `dockerSwarmClusters` DockerSwarmClusterRelationSelectSchema: What a select may name of the DockerSwarmCluster records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `dockerVersion` boolean
      - `lastSeenAt` boolean
      - `swarmId` boolean
    - `cephClusters` CephClusterRelationSelectSchema: What a select may name of the CephCluster records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `fsid` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `cephVersion` boolean
      - `lastSeenAt` boolean
    - `storageArrays` StorageArrayRelationSelectSchema: What a select may name of the StorageArray records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `storageSystem` boolean
      - `reportedName` boolean
      - `systemId` boolean
      - `osName` boolean
      - `osVersion` boolean
      - `otelCollectorStatus` boolean
      - `agentVersion` boolean
      - `lastSeenAt` boolean
      - `capacityBytes` boolean
      - `usedBytes` boolean
    - `cloudResources` CloudResourceRelationSelectSchema: What a select may name of the CloudResource records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `resourceIdentifier` boolean
      - `cloudPlatform` boolean
      - `cloudProvider` boolean
      - `cloudRegion` boolean
      - `cloudAccountId` boolean
      - `cloudResourceKind` boolean
      - `cloudResourceType` boolean
      - `cloudResourceGroup` boolean
      - `healthSeverity` boolean
      - `cloudConnectionId` boolean
      - `runtimeName` boolean
      - `runtimeVersion` boolean
      - `lastSeenAt` boolean
    - `databaseServers` DatabaseServerRelationSelectSchema: What a select may name of the DatabaseServer records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `databaseIdentifier` boolean
      - `dbSystem` boolean
      - `serverAddress` boolean
      - `serverPort` boolean
      - `discoverySource` boolean
      - `otelCollectorStatus` boolean
      - `lastSeenAt` boolean
    - `dockerResources` DockerResourceRelationSelectSchema: What a select may name of the DockerResource records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `dockerHostId` boolean
      - `kind` boolean
      - `name` boolean
      - `containerId` boolean
      - `imageName` boolean
      - `state` boolean
      - `latestCpuPercent` boolean
      - `latestMemoryBytes` boolean
      - `metricsUpdatedAt` boolean
      - `lastSeenAt` boolean
      - `resourceCreationTimestamp` boolean
    - `podmanResources` PodmanResourceRelationSelectSchema: What a select may name of the PodmanResource records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `podmanHostId` boolean
      - `kind` boolean
      - `name` boolean
      - `containerId` boolean
      - `imageName` boolean
      - `state` boolean
      - `latestCpuPercent` boolean
      - `latestMemoryBytes` boolean
      - `metricsUpdatedAt` boolean
      - `lastSeenAt` boolean
      - `resourceCreationTimestamp` boolean
    - `services` ServiceRelationSelectSchema: What a select may name of the Service records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `serviceColor` boolean
      - `serviceLanguage` boolean
      - `techStack` boolean
      - `lastSeenAt` boolean
      - `serviceVersion` boolean
      - `deploymentEnvironment` boolean
      - `serviceNamespace` boolean
      - `runtimeName` boolean
      - `runtimeVersion` boolean
      - `telemetrySdkLanguage` boolean
      - `cloudProvider` boolean
      - `cloudPlatform` boolean
      - `cloudRegion` boolean
      - `cloudAccountId` boolean
    - `serviceLevelObjectives` ServiceLevelObjectiveRelationSelectSchema: What a select may name of the ServiceLevelObjective records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `projectId` boolean
      - `name` boolean
      - `description` boolean
      - `sliType` boolean
      - `targetPercentage` boolean
    - `labels` LabelRelationSelectSchema: What a select may name of the Label records a relation holds: set a field to true to include it.
      - `_id` boolean
      - `createdAt` boolean
      - `updatedAt` boolean
      - `deletedAt` boolean
      - `name` boolean
      - `projectId` boolean
      - `color` boolean
      - `isArchived` boolean
    - `currentAlertStateId` boolean
    - `alertSeverityId` boolean
    - `monitorStatusWhenThisAlertWasCreatedId` boolean
    - `customFields` boolean
    - `rootCause` boolean
    - `createdStateLog` boolean
    - `createdCriteriaId` boolean
    - `seriesFingerprint` boolean
    - `seriesLabels` boolean
    - `monitorSummary` boolean
    - `createdByProbeId` boolean
    - `isCreatedAutomatically` boolean
    - `remediationNotes` boolean
    - `telemetryQuery` boolean
    - `alertNumber` boolean
    - `alertNumberWithPrefix` boolean
    - `alertEpisodeId` boolean
    - `isPrivate` boolean
    - `enableReminders` boolean
    - `nextReminderNotificationAt` boolean
    - `reminderNotificationSentCount` boolean
    - `nextIncidentRuleCheckAt` boolean

## Response `200`

Successful response

- object
  - `data` Alert
    - `_id` string, uuid: ID of this object. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `version` number: Object version
    - `projectId` string, uuid, required: ID of your OneUptime Project in which this object belongs. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `title` string, required: Title of this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `description` string: Short description of this alert. This will be visible on the status page. This is in markdown. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `impactStartedAt` object: When customer impact actually began. Left blank until someone records it - never inferred, because a guessed value is worse than no value. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `firstPagedAt` object: When an on-call policy or a direct page first notified someone about this alert. Empty until someone is paged. Set by OneUptime. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `createdByUserId` string, uuid: User ID who created this object (if this object was created by a User). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `monitorId` string, uuid: ID of the monitor this alert belongs to. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `onCallDutyPolicies` object[]: List of on-call duty policies affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `hosts` object[]: List of hosts affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `networkDevices` object[]: List of network devices affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `kubernetesClusters` object[]: List of Kubernetes clusters affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `kubernetesResources` object[]: List of Kubernetes resources (pods, deployments, nodes, etc.) affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `kubernetesContainers` object[]: List of Kubernetes containers affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `dockerHosts` object[]: List of Docker hosts affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `podmanHosts` object[]: List of Podman hosts affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `proxmoxClusters` object[]: List of Proxmox clusters affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `openStackClouds` object[]: List of OpenStack clouds affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `vmwareVCenters` object[]: List of vCenters affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `iotFleets` object[]: List of IoT fleets affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `dockerSwarmClusters` object[]: List of Docker Swarm clusters affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `cephClusters` object[]: List of Ceph clusters affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `storageArrays` object[]: List of storage arrays affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `cloudResources` object[]: List of cloud resources affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `databaseServers` object[]: List of databases affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `dockerResources` object[]: List of Docker resources (containers, images, networks, volumes) affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `podmanResources` object[]: List of Podman resources (containers, images, networks, volumes) affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `services` object[]: List of services affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `serviceLevelObjectives` object[]: List of Service Level Objectives (SLOs) affected by this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `labels` object[]: Labels to group and filter by. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
      - `_id` string, uuid: Unique identifier for the entity
    - `currentAlertStateId` string, uuid, required: Current Alert State ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `alertSeverityId` string, uuid, required: Alert Severity ID. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `monitorStatusWhenThisAlertWasCreatedId` string, uuid: Monitor Status ID when this alert was created. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `customFields` object: Custom Fields on this resource. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `isOwnerNotifiedOfAlertCreation` boolean, required: Are owners notified of when this alert is created? Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `rootCause` string: What is the root cause of this alert? Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `createdStateLog` object: Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `createdCriteriaId` string: If this alert was created by a Probe, this is the ID of the criteria that created it. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `seriesFingerprint` string: For metric monitors with per-series alerting (e.g. grouped by host.name), this is a stable hash of the series label values so one alert is created per affected series. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `seriesLabels` object: Attribute key/value pairs that identify the affected series (e.g. {host.name: prod-db-01}) when this alert was created from a per-series metric breach. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `monitorSummary` object: The monitor summary captured at the moment this alert was created - the same card the monitor page shows, frozen so it survives the monitor log being aged out. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `createdByProbeId` string, uuid: If this alert was created by a Probe, this is the ID of the probe that created it. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `isCreatedAutomatically` boolean: Is this alert created by OneUptime Probe or Workers automatically (and not created manually by a user)? Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `remediationNotes` string: Notes on how to remediate this alert. This is in markdown. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `telemetryQuery` object: Telemetry query for this alert. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `alertNumber` number: Alert Number. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `alertNumberWithPrefix` string: Alert number with prefix (e.g., 'ALT-42' or '#42'). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `alertEpisodeId` string, uuid: The ID of the latest episode this alert is a member of, if any. Read-only: set by OneUptime when the alert is added to or removed from an episode's members (Alert Episode Member). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `isPrivate` boolean: If true, this alert is only visible to its owners (users in 'owner users' and members of 'owner teams'), project admins, and project owners. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `enableReminders` boolean: Should reminder notifications be sent to owners while this alert is still open? Reminders are sent based on the reminder rules configured for this project. Permissions - Create: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Create Alert], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [Project Owner, Project Admin, Project Member, Alert Admin, Alert Member, Edit Alert]
    - `nextReminderNotificationAt` object: When will the next reminder notification be sent to owners of this alert? This is set automatically based on the reminder rules configured for this project. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `reminderNotificationSentCount` number: How many reminder notifications have been sent to owners of this alert so far. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]
    - `nextIncidentRuleCheckAt` object: When OneUptime next checks whether an incident should be declared from this alert: set while an alert incident rule that matched it waits for the alert to stay unresolved, and empty otherwise. Set by OneUptime; it cannot be written. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Project Member, Viewer, Alert Admin, Alert Member, Alert Viewer, Read Alert], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)