Monitors

Creating an Access Token

Access Tokens can be your API or Personal Tokens managed inside your account setings.

API Token

API Tokens allow access to datasets for either querying data, ingesting data, or both. In your settings menu click on API Tokens and create your API Token

• Learn more about API Tokens

Personal Token

Personal tokens allows you to access the Axiom API programmatically for custom integrations. In your settings menu, click on Profile and select Personal Token.

• Learn more about Personal Tokens

GET /monitors

GET /api/v1/monitors

Example Request

curl -X 'GET' \
  'https://cloud.axiom.co/api/v1/monitors' \
  -H 'Authorization: Bearer <$PERSONAL_TOKEN>' \
  -H 'X-Axiom-Org-ID: <$ORG_ID>'

Example Response

Response sample code 200 and the body.

[
  {
    "aplQuery": true,
    "comparison": "Below",
    "dataset": "string",
    "description": "string",
    "disabledUntil": "string",
    "durationMinutes": 0,
    "frequencyMinutes": 0,
    "id": "string",
    "lastCheckState": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    },
    "lastCheckTime": "string",
    "name": "string",
    "noDataCloseWaitMinutes": 0,
    "notifiers": [
      "string"
    ],
    "query": {},
    "threshold": 0
  }
]

POST /monitors

POST /api/v1/monitors

Example Request

curl -X 'POST' \
  'https://cloud.axiom.co/api/v1/monitors' \
  -H 'Authorization: Bearer <$API_TOKEN or $PERSONAL_TOKEN>' \
  -H 'X-Axiom-Org-ID: <$ORG_ID>'
  -H 'Content-Type: application/json' \
  -d '{
  "aplQuery": true,
  "comparison": "Below",
  "dataset": "string",
  "description": "string",
  "disabledUntil": "string",
  "durationMinutes": 0,
  "frequencyMinutes": 0,
  "id": "string",
  "lastCheckState": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "lastCheckTime": "string",
  "name": "string",
  "noDataCloseWaitMinutes": 0,
  "notifiers": [
    "string"
  ],
  "query": {},
  "threshold": 0
}'

Example Response

Response sample code 200 and the body.

{
  "aplQuery": true,
  "comparison": "Below",
  "dataset": "string",
  "description": "string",
  "disabledUntil": "string",
  "durationMinutes": 0,
  "frequencyMinutes": 0,
  "id": "string",
  "lastCheckState": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "lastCheckTime": "string",
  "name": "string",
  "noDataCloseWaitMinutes": 0,
  "notifiers": [
    "string"
  ],
  "query": {},
  "threshold": 0
}

DELETE /monitors/{id}

DELETE /api/v1/monitors/{id}

Example Request

curl -X 'DELETE' \
  'https://cloud.axiom.co/api/v1/monitors/<monitors_id>' \
  -H 'Authorization: Bearer <$PERSONAL_TOKEN>' \
  -H 'X-Axiom-Org-ID: <$ORG_ID>'

Example Response

A successful response will have status code 204 and an empty body.

GET /monitors/{id}

GET /api/v1/monitors/{id}

Example Request

curl -X 'GET' \
  'https://cloud.axiom.co/api/v1/monitors/stringid' \
  -H 'Authorization: Bearer <$PERSONAL_TOKEN>' \
  -H 'X-Axiom-Org-ID: <$ORG_ID>'

Example Response

Response sample code 200 and the body.

{
  "aplQuery": true,
  "comparison": "Below",
  "dataset": "string",
  "description": "string",
  "disabledUntil": "string",
  "durationMinutes": 0,
  "frequencyMinutes": 0,
  "id": "string",
  "lastCheckState": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "lastCheckTime": "string",
  "name": "string",
  "noDataCloseWaitMinutes": 0,
  "notifiers": [
    "string"
  ],
  "query": {},
  "threshold": 0
}

PUT /monitors/{id}

PUT /api/v1/monitors/{id}

Example Request

curl -X 'PUT' \
  'https://cloud.axiom.co/api/v1/monitors/id' \
  -H 'Authorization: Bearer <$PERSONAL_TOKEN>' \
  -H 'X-Axiom-Org-ID: <$ORG_ID>'
  -H 'Content-Type: application/json' \
  -d '{
  "aplQuery": true,
  "comparison": "Below",
  "dataset": "string",
  "description": "string",
  "disabledUntil": "string",
  "durationMinutes": 0,
  "frequencyMinutes": 0,
  "id": "string",
  "lastCheckState": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "lastCheckTime": "string",
  "name": "string",
  "noDataCloseWaitMinutes": 0,
  "notifiers": [
    "string"
  ],
  "query": {},
  "threshold": 0
}'

Example Response

Response sample code 200 and the body.

{
  "aplQuery": true,
  "comparison": "Below",
  "dataset": "string",
  "description": "string",
  "disabledUntil": "string",
  "durationMinutes": 0,
  "frequencyMinutes": 0,
  "id": "string",
  "lastCheckState": {
    "additionalProp1": "string",
    "additionalProp2": "string",
    "additionalProp3": "string"
  },
  "lastCheckTime": "string",
  "name": "string",
  "noDataCloseWaitMinutes": 0,
  "notifiers": [
    "string"
  ],
  "query": {},
  "threshold": 0
}