Monitors

---

Edit Monitor

Request

PATCH /monitors/uuid

Parameter

Name	Type	Description
uuid	string	Required -- Monitor uuid
name	string	Name of the Monitor
title	string	Title of Monitor for Status Page (Optional)
type	string	Scheme or Protocol
urn	string	Urn address
followRedirects	bool	If selected, it will wait until the end of the redirect to get the response
timeout	float64	Timeout in seconds
interval	int64	Interval in seconds
regions	int64[]	An array of regions ids
description	string	Monitor description
groups	string[]	An array of groups uuid
degradedThreshold	float64	Degraded value in seconds
apdexThreshold	float64	Apdex value in seconds
httpRequest	HttpRequest	Monitor HTTP Request Options (See HttpRequest parameters)
httpResponse	HttpResponse	Monitor HTTP Response Options (See HttpResponse parameters)
tcpOptions	TcpOptions	Monitor TCP Options (See TcpOptions parameters)
maintenance	Maintenance	Scheduled maintenance of the monitor. (See Maintenance window parameters)

HttpRequest Parameters

Name	Type	Description
method	string	HTTP method to send in the request. Options are: GET | POST | PUT | PATCH | DELETE | HEAD | OPTIONS
headers	HttpHeader[]	Array of HTTP Header Objects (See HttpHeader paramenters)
body	string	Body to send in request

HttpResponse Parameters

Name	Type	Description
status	string[]	Array of number status code in response
statusMatches	bool	Status must match or not
keywordHeader	string	Keyword in Header (case insensitive)
keywordHeaderExists	bool	Keyword in header must exist or not
keywordBody	string	Ketword body in Response (case insensitive)
keywordBodyExists	bool	Keyword body must exist or not

HttpHeader Parameter

Name	Type	Description
name	string	Name of Header
value	string	Value of Header

Tcp Options Parameters

Name	Type	Description
dataRequest	string	Data for sending to the TCP server
keywordResponse	string	Keyword in the Data Response (case insensitive)
keywordResponseExists	bool	Keyword in the Data Response must exists or not (case insensitive)

Maintenance window Parameters

Name	Type	Description
days	string[]	The days of the week when the monitor will undergo maintenance.
times	MaintenanceTime[]	The maintenance hours (See Maintenance Time parameters)
timeZone	string	The Time Zone to set the maintenance hours

Maintenance Time Parameters

Name	Type	Description
startHour	int	Start hour
startMinute	int	Start minute
stopHour	int	End hour
stopMinute	int	End mnute

Request Payload Example

{
  "name": "Example Monitor",
  "title": "Title for Example Monitor",
  "type": "https",
  "urn": "example.com",
  "description": "Description",
  "interval": "2",
  "regions": [ 1, 5 ],
  "groups": [ "1ca46e77ad704f2894f9c0f73491a72a","2429fc0af1d9437fa770abc94c03341f" ],
  "degradedThreshold": 2,
  "apdexThreshold": 0.75
}

Request Curl Example

curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 6880e91a09e40a5d70976257c7dd8df6f6cc0597a5dd447824f2275b7d9fdcff" \
-d \
  '{
      "name":"Example Monitor",
      "title":"Title for Example Monitor",
      "type":"https",
      "urn":"example.com",
      "intervalId":2,
      "description":"Description",
      "regions":[ 1, 5 ],
      "groups":["1ca46e77ad704f2894f9c0f73491a72a", "2429fc0af1d9437fa770abc94c03341f"],
      "degradedThreshold":2,
      "apdexThreshold":0.75
  }' \
"https://api.statsignal.dev/v1/monitors/f1bae3eb67884d49b96573975131b464"

Response Example

Status: 200 updated

{
  "monitor": {
    "uuid": "f1bae3eb67884d49b96573975131b464",
    "name": "Example Monitor",
    "title": "Title for Example Monitor",
    "type": "https",
    "urn": "example.com",
    "httpFollowRedirects": false,
    "timeout": 10,
    "intervalId": 2,
    "regions": [
      1,
      5
    ],
    "description": "Description",
    "groups": [
      "2429fc0af1d9437fa770abc94c03341f",
      "1ca46e77ad704f2894f9c0f73491a72a"
    ],
    "alerts": [
      "ac76e6cff57645abbd03f3313f8a7d85"
    ],
    "tcpOptions": null,
    "httpRequest": null,
    "httpResponse": null,
    "degradedThreshold": 2,
    "apdexThreshold": 0.75,
    "maintenance": {
      "days": [
        0,
        6
      ],
      "times": [
        {
          "startHour": 12,
          "startMinute": 0,
          "stopHour": 13,
          "stopMinute": 0
        },
        {
          "startHour": 13,
          "startMinute": 30,
          "stopHour": 14,
          "stopMinute": 0
        }
      ],
      "timeZone": "America/Chicago"
    },
    "createdAt": "2023-06-27T05:18:19.150642Z",
    "updatedAt": "2023-06-27T13:23:17.638411Z"
  }
}