> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/ai-sre/api-reference/alerts.md).

# Alerts

## POST /api/v1/mc/alerts/{alertId}/acknowledge

> Acknowledge alert

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts/{alertId}/acknowledge":{"post":{"tags":["Alerts"],"summary":"Acknowledge alert","operationId":"acknowledge_alert","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"alertId","in":"path","description":"Alert ID, e.g. ALERT-123","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Alert acknowledged","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"404":{"description":"Alert not found"}}}}},"components":{"schemas":{"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```

## GET /api/v1/mc/alerts

> List alerts

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts":{"get":{"tags":["Alerts"],"summary":"List alerts","operationId":"list_project_alerts","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"status","in":"query","description":"Filter by status (multi-value, OR-combined). Allowed: triggered, acknowledged, resolved, dismissed.","schema":{"type":"array","items":{"type":"string"}}},{"name":"priority","in":"query","description":"Filter by priority option id (multi-value, OR-combined)","schema":{"type":"array","items":{"type":"string"}}},{"name":"impactedService","in":"query","description":"Filter by service: Harness identifier, name, or ID (multi-value, OR-combined)","schema":{"type":"array","items":{"type":"string"}}},{"name":"environment","in":"query","description":"Filter by environment (multi-value, OR-combined), each a Harness environment identifier, name, or serialized HarnessEnvironmentId. Identifiers are matched before names. A reference shared by several scopes resolves to the closest: this project, then its org, then the account, then other projects in (org, project) order.","schema":{"type":"array","items":{"type":"string"}}},{"name":"templateShortId","in":"query","description":"Filter by alert template short id (multi-value, OR-combined), e.g. PALERTAED1EE","schema":{"type":"array","items":{"type":"string"}}},{"name":"text","in":"query","description":"Free-text search across title and description","schema":{"type":"string"}},{"name":"createdAfter","in":"query","description":"ISO-8601 inclusive lower bound on createdAt, e.g. 2026-05-01T00:00:00Z","schema":{"type":"string"}},{"name":"createdBefore","in":"query","description":"ISO-8601 inclusive upper bound on createdAt","schema":{"type":"string"}},{"name":"sortField","in":"query","description":"Field to sort on","schema":{"type":"string","description":"Field to sort alerts by","enum":["CREATED_AT","PRIORITY","STATUS"]}},{"name":"sortDirection","in":"query","description":"Sort direction. For priority, DESC is most critical first and ASC is least critical first; omitted defaults to most-critical-first. Other fields use the requested direction as-is.","schema":{"type":"string","description":"Sort direction","enum":["ASC","DESC"]}},{"name":"pageSize","in":"query","description":"Page size requested","schema":{"type":"integer","format":"int32"}},{"name":"page","in":"query","description":"0-based page number; defaults to 0 (the first page).","schema":{"minimum":0,"type":"integer","format":"int32"}}],"responses":{"200":{"description":"Page of alerts","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OffsetPaginatedResultAlertResponse"}}}}}}}},"components":{"schemas":{"OffsetPaginatedResultAlertResponse":{"type":"object","properties":{"entities":{"type":"array","items":{"$ref":"#/components/schemas/AlertResponse"}},"totalCount":{"type":"integer","format":"int32"}}},"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```

## POST /api/v1/mc/alerts/{alertId}/dismiss

> Dismiss alert

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts/{alertId}/dismiss":{"post":{"tags":["Alerts"],"summary":"Dismiss alert","operationId":"dismiss_alert","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"alertId","in":"path","description":"Alert ID, e.g. ALERT-123","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Alert dismissed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"404":{"description":"Alert not found"}}}}},"components":{"schemas":{"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```

## GET /api/v1/mc/alerts/{alertId}

> Get alert detail

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts/{alertId}":{"get":{"tags":["Alerts"],"summary":"Get alert detail","operationId":"get_alert","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"alertId","in":"path","description":"Alert ID, e.g. ALERT-123","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Alert detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"404":{"description":"Alert not found"}}}}},"components":{"schemas":{"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```

## PATCH /api/v1/mc/alerts/{alertId}

> Update alert

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts/{alertId}":{"patch":{"tags":["Alerts"],"summary":"Update alert","operationId":"update_alert","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"alertId","in":"path","description":"Alert ID, e.g. ALERT-123","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAlertRequest"}}}},"responses":{"200":{"description":"Alert updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"400":{"description":"Invalid request"},"404":{"description":"Alert not found"}}}}},"components":{"schemas":{"UpdateAlertRequest":{"type":"object","properties":{"title":{"type":"string","description":"Alert title","nullable":true},"description":{"type":"string","description":"Alert description","nullable":true},"priority":{"type":"string","description":"Alert priority option id (p1_critical, p2_error, p3_warning, p4_info). To acknowledge, resolve, or dismiss an alert, use the dedicated lifecycle endpoints instead.","nullable":true},"status":{"type":"string","description":"Alert status option id. To acknowledge, resolve, or dismiss, use POST /api/v1/mc/alerts/{alertId}/acknowledge|resolve|dismiss. Reopening to triggered is allowed here.","nullable":true},"impactedServices":{"type":"array","description":"Impacted services by Harness identifier, name, or ID (replaces the full list)","nullable":true,"items":{"type":"string","description":"Impacted services by Harness identifier, name, or ID (replaces the full list)","nullable":true}},"environments":{"type":"array","description":"Harness environment identifiers (replaces the full list)","nullable":true,"items":{"type":"string","description":"Harness environment identifiers (replaces the full list)","nullable":true}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert","nullable":true},"quietMode":{"type":"boolean","description":"When true, suppresses user notifications and on-call pages for this alert","nullable":true}},"description":"JSON merge-patch body for updating an alert. Omit a field to leave it unchanged; set it to null to clear it."},"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```

## POST /api/v1/mc/alerts/{alertId}/resolve

> Resolve alert

```json
{"openapi":"3.0.1","info":{"title":"Harness AI SRE API","version":"v1"},"servers":[{"url":"https://app.harness.io/gateway/ir/tp"}],"security":[{}],"paths":{"/api/v1/mc/alerts/{alertId}/resolve":{"post":{"tags":["Alerts"],"summary":"Resolve alert","operationId":"resolve_alert","parameters":[{"name":"accountId","in":"query","description":"Harness account identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"orgId","in":"query","description":"Harness organization identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"projectId","in":"query","description":"Harness project identifier.","required":true,"schema":{"minLength":1,"type":"string"}},{"name":"alertId","in":"path","description":"Alert ID, e.g. ALERT-123","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Alert resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertResponse"}}}},"404":{"description":"Alert not found"}}}}},"components":{"schemas":{"AlertResponse":{"required":["prettyId","projectId","title"],"type":"object","properties":{"prettyId":{"type":"string","description":"Alert pretty id, e.g. ALERT-123"},"projectId":{"type":"string"},"title":{"type":"string"},"description":{"type":"string","description":"Alert description"},"status":{"type":"string","description":"Resolved alert status option id (e.g. triggered, resolved)"},"priority":{"$ref":"#/components/schemas/Priority"},"impactedServices":{"type":"array","description":"Harness service identifiers for impacted services","items":{"type":"string","description":"Harness service identifiers for impacted services"}},"environments":{"type":"array","description":"Environment labels (e.g. prod, qa)","items":{"type":"string","description":"Environment labels (e.g. prod, qa)"}},"monitoringLink":{"type":"string","description":"Monitoring link for the alert"},"deduplicationId":{"type":"string","description":"Deduplication / correlation key"},"quietMode":{"type":"boolean","description":"When true, suppresses notifications and on-call pages"},"keyEvents":{"type":"array","description":"Key events timeline","items":{"$ref":"#/components/schemas/KeyEventInfo"}},"relatedActivities":{"type":"array","description":"Related activities","items":{"$ref":"#/components/schemas/RelatedActivity"}},"relatedExternalEntities":{"type":"array","description":"External items (deployments, PRs, tickets, URLs) linked to this activity","items":{"$ref":"#/components/schemas/RelatedExternalEntity"}},"commsLinks":{"type":"array","description":"Communication links (includes a WEB link to the alert)","items":{"$ref":"#/components/schemas/CommsLink"}},"createdAtTimestamp":{"type":"integer","description":"Epoch timestamp when created (milliseconds)","format":"int64"},"startedAtTimestamp":{"type":"integer","description":"Epoch timestamp when the alert started (milliseconds)","format":"int64"},"acknowledgedAtTimestamp":{"type":"integer","description":"Epoch timestamp when acknowledged (milliseconds)","format":"int64"},"resolvedAtTimestamp":{"type":"integer","description":"Epoch timestamp when resolved (milliseconds)","format":"int64"},"closedAtTimestamp":{"type":"integer","description":"Epoch timestamp when closed (milliseconds)","format":"int64"}}},"Priority":{"type":"object","properties":{"id":{"type":"string","description":"Priority option id"},"label":{"type":"string","description":"Display label resolved from the activity template"}},"description":"Alert priority"},"KeyEventInfo":{"type":"object","properties":{"timestamp":{"type":"integer","description":"Epoch milliseconds when the event occurred","format":"int64"},"status":{"type":"string","description":"Status at the time of the event"},"details":{"type":"string","description":"Human-readable details"}},"description":"Key event in the incident timeline"},"RelatedActivity":{"required":["globalId","name","prettyId","templateTypeName","title"],"type":"object","properties":{"name":{"type":"string","description":"Relationship verb (e.g., \"relates to\")"},"templateTypeName":{"type":"string","description":"Template type name","enum":["INCIDENT","ALERT","DEPLOY","CHANGE"]},"prettyId":{"type":"string"},"globalId":{"type":"string"},"title":{"type":"string"}},"description":"Related activities"},"RelatedExternalEntity":{"required":["externalId","name","provider","relationshipGlobalId","type","url"],"type":"object","properties":{"relationshipGlobalId":{"type":"string","description":"Global ID of the link; pass this to the delete endpoint"},"name":{"type":"string","description":"Relationship verb with the activity as the subject (e.g., \"is caused by\")"},"type":{"type":"string","enum":["DEPLOYMENT","BUILD","PULL_REQUEST","TICKET","FEATURE_FLAG","LINK"]},"provider":{"type":"string","enum":["HARNESS","GITHUB","GITLAB","BITBUCKET","JIRA","SERVICENOW","GENERIC"]},"externalId":{"type":"string","description":"Canonical identifier within (type, provider), e.g. \"owner/repo#123\" or \"IR-3638\""},"url":{"type":"string"},"displayName":{"type":"string"}},"description":"An external item (deployment, PR, ticket, URL) linked to an activity"},"CommsLink":{"required":["linkType","url"],"type":"object","properties":{"url":{"type":"string"},"linkType":{"type":"string","enum":["WEB","SLACK"]}},"description":"Communication links"}}}}
```