Skip to main content
PATCH
Update a monitor

Authorizations

Authorization
string
header
required

Sent as Authorization: Bearer <token>. Three kinds are accepted: an ORG token (sv_…), bound to one workspace with a fixed role; a PERSONAL token (svu_…), which acts as you with your own live role in whichever workspace it is pointed at; and an OAUTH access token (mcp_at_…) from a connected app, limited to the workspaces you granted it. A personal or OAuth token names its workspace with the X-Sentivel-Workspace header (a slug or an id). Without it an OAuth token falls back to the connection's primary workspace, while a personal token in more than one workspace is rejected 400 invalid_request with the choices in error.details.workspaces. Membership is re-read every request, so leaving a workspace or revoking the grant takes effect at once.

Path Parameters

id
string<uuid>
required

Body

application/json

All fields optional; only provided fields change.

name
string
Required string length: 1 - 120
target
string<uri>
method
enum<string>
Available options:
GET,
HEAD,
POST
intervalSeconds
integer
Required range: 60 <= x <= 86400
timeoutMs
integer
Required range: 1000 <= x <= 30000
openThreshold
integer
Required range: 1 <= x <= 10
resolveThreshold
integer
Required range: 1 <= x <= 10
expectedStatusCodes
integer[]
Required range: 100 <= x <= 599
keyword
string
Maximum string length: 200
keywordAbsent
string
Maximum string length: 200
jsonAssertion
object
degradedAfterMs
integer
Required range: 1 <= x <= 60000
latencyThresholdMs
integer
Required range: 1 <= x <= 60000
headers
object

Replace the monitor's custom request headers (stored encrypted).

body
string

Replace the monitor's request body (stored encrypted).

Maximum string length: 32768
contentType
string
Maximum string length: 200
environment
string | null
Maximum string length: 60
enabled
boolean

Pause/resume the monitor.

Response

The updated monitor.

data
object