v64

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-03124241726.5 KB

Monitors

Update monitor

Updates a monitor's metadata and incident severity. Target, trigger, metric, and conditions are fixed after creation. System monitor edits are restricted.

patch/v1/projects/{projectSlug}/monitors/{monitorSlug}

Path parameters

projectSlugstring required

Project slug (human-readable identifier)

monitorSlugstring required

Monitor slug (human-readable identifier within the project).

Request body

namestring

New name. Renaming may regenerate the slug — re-read the response or rely on id.

descriptionstring

New description.

severity'low' | 'medium' | 'high'

Replacement incident severity.

Response

Updated monitor

idstring required

Stable monitor identifier.

organizationIdstring required

Organization that owns this monitor.

projectIdstring required

Project this monitor belongs to.

slugstring required

URL-safe slug derived from name. Unique within the project.

namestring required

Human-readable name.

descriptionstring required

Free-form description. Empty string when not set.

systemboolean required

true for auto-provisioned system monitors, which cannot be deleted or edited; false otherwise.

mutedAtstring nullable required

ISO-8601 timestamp at which the monitor was muted, or null when active.

deletedAtstring nullable required

ISO-8601 timestamp at which the monitor was deleted, or null.

createdAtstring required

ISO-8601 timestamp of creation.

updatedAtstring required

ISO-8601 timestamp of the last update.