Monitor Alerts

Monitor alerts represent detected prompt-injection or schema-change events.

Monitor Alerts object

Attributes

object

String

id

String

status

Enum

monitor

Object

proto_guard_alert_id

StringNullable

proto_guard_run_id

StringNullable

specification_change_notification

ObjectNullable

created_at

Date

resolved_at

DateNullable

recipients

Object

events

Object
{
  "object": "monitor.alert",
  "status": "pending",
  "monitor": {
    "object": "monitor",
    "target": "protoguard_filter",
    "status": "active",
    "owner": "organization"
  },
  "specification_change_notification": {
    "object": "provider.specification_change_notification",
    "from_specification": {
      "object": "provider.capabilities.specification#preview"
    },
    "to_specification": {
      "object": "provider.capabilities.specification#preview"
    },
    "from_provider_version": {
      "object": "provider.version#preview"
    },
    "to_provider_version": {
      "object": "provider.version#preview"
    }
  },
  "recipients": [
    {
      "object": "monitor.alert_recipient"
    },
    {
      "object": "monitor.alert_recipient"
    }
  ],
  "events": [
    {
      "object": "monitor.alert_event",
      "type": "created"
    },
    {
      "object": "monitor.alert_event",
      "type": "created"
    }
  ]
}

List monitor alerts

Returns a paginated list of monitor alerts for this instance.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

monitor_id

UnionOptional

status

UnionOptional

target

UnionOptional

source

UnionOptional

provider_id

UnionOptional

proto_guard_alert_id

UnionOptional

proto_guard_run_id

UnionOptional

proto_guard_filter_id

UnionOptional

specification_change_notification_id

UnionOptional

session_id

UnionOptional

session_message_id

UnionOptional

session_connection_id

UnionOptional

provider_run_id

UnionOptional

created_at

ObjectOptional

Filter monitor alert creation time by date range

resolved_at

ObjectOptional

Filter monitor alert resolution time by date range

GEThttp://api.metorial.com/monitor-alerts
curl -X GET "https://api.metorial.com/monitor-alerts" \
  -H "Authorization: Bearer metorial_sk_..."

Get monitor alert

Retrieves a monitor alert by ID.

URL Parameters

monitor_alert_id

String

The unique identifier for the monitor_alert

GEThttp://api.metorial.com/monitor-alerts/:monitor_alert_id
curl -X GET "https://api.metorial.com/monitor-alerts/mon_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Mark monitor alert viewed

Marks a monitor alert as viewed by the current actor.

URL Parameters

monitor_alert_id

String

The unique identifier for the monitor_alert

POSThttp://api.metorial.com/monitor-alerts/:monitor_alert_id/viewed
curl -X POST "https://api.metorial.com/monitor-alerts/mon_Rm4Mnheq2bfEPhBhP7SY/viewed" \
  -H "Authorization: Bearer metorial_sk_..."

Resolve monitor alert

Marks a monitor alert as resolved.

URL Parameters

monitor_alert_id

String

The unique identifier for the monitor_alert

POSThttp://api.metorial.com/monitor-alerts/:monitor_alert_id/resolve
curl -X POST "https://api.metorial.com/monitor-alerts/mon_Rm4Mnheq2bfEPhBhP7SY/resolve" \
  -H "Authorization: Bearer metorial_sk_..."

Unresolve monitor alert

Reopens a resolved monitor alert.

URL Parameters

monitor_alert_id

String

The unique identifier for the monitor_alert

POSThttp://api.metorial.com/monitor-alerts/:monitor_alert_id/unresolve
curl -X POST "https://api.metorial.com/monitor-alerts/mon_Rm4Mnheq2bfEPhBhP7SY/unresolve" \
  -H "Authorization: Bearer metorial_sk_..."