Skip to main content

Monitors

List Monitors

Returns the monitors visible to the caller, newest first. A human filtering by project sees that project’s monitors plus workspace-wide monitors. A project-scoped API key sees only monitors in its strict project scope. Use starting_after or ending_before to page.

Create a Monitor

Creates a monitor (custom observability dashboard) in the workspace. Set project_id to scope the monitor to a project; omit it to create a workspace-wide monitor, which requires admin access.

List Presets

Returns the built-in monitor templates (preset dashboards and preset widgets). Presets are defined by the platform and versioned with it; create a monitor from a preset by copying its widgets into a create request and stamping preset_key.

Retrieve a Monitor

Retrieves a monitor by ID.

Delete a Monitor

Permanently deletes a monitor. Widgets are stored inline, so no other resources are affected.

Update a Monitor

Updates monitor metadata and widgets. With update_mask, listed paths are replaced and widgets may be explicitly cleared. Without update_mask, legacy behavior is preserved: a non-empty widgets array replaces the set and an empty or omitted array keeps it. project_id is immutable.