Create Multiple Synthetic API Monitoring Jobs API
This page describes the API used to create multiple Synthetic API monitoring jobs using a single API request.
Create Multiple API Monitoring Jobs
Creates multiple API monitoring jobs with the specified JSON payload.
Resource URL
POST <api_server_URL>/v1/synthetic/api/schedule/batch
Request/Response Format
JSON
Example:
- Request
{ "schedules": [ { "scheduleRunConfigs": [ { "rate": { "value": 15, "unit": "MINUTES" }, "daysOfWeek": [ "SUN", "WED", "THUR", "FRI", "MON", "TUES", "SAT" ], "timezone": "UTC" } ], "description": "jobUI", "apiMetadata": { "script": { "contentType": "JAVASCRIPT", "script": "// Javascript based API Monitoring Test\n\nconst assert = require(\"assert\");\n(async () => {\n var response = await client.get(\"<URL>\");\n assert.equal(response.statusCode, 200);\n assert.equal(response.statusMessage, \"OK\");\n for(var key in response.headers) {\n console.log(`${key} : ${response.headers[key]}`);\n }\n assert.equal(response.body, \"response body\");\n})()" } }, "browserCodes": [ "API" ], "chromeVersions": [], "locationCodes": [ "M50" ], "timeoutSeconds": 15, "appKey": "appKey", "composableConfig": { "numBeforeConfirmedError": 0, "resourceErrorDetection": { "ignoreWhen": { "resourceUrlContains": [], "resourceMimeType": [] }, "onlyWhen": { "resourceUrlContains": [], "resourceMimeType": [] } } }, "performanceCriteria": { "retestOnWarning": false, "retestOnCritical": false, "warningCriterion": [], "criticalCriterion": [] } } ] }
- Response
[ { "status": "200", "errorMessage": "null", "scheduleId": "ID" }, { "status": "422", "errorMessage": "timeout field value exceeds range", "scheduleId": "null" } ]
Request Parameters
Parameter Name | Parameter Type | Value | Description | Mandatory Request |
---|---|---|---|---|
scheduleRunConfigs | - |   |   | No |
rate | - |   |   | No |
value | number | Minutes: 1 - 60 Hours: 1 - 24 Days: "null" |   | No |
unit | String | Minutes, Hours, or Days |   | No |
daysOfWeek | String | "SUN", "MON", "TUES", "WED", "THUR", "FRI", "SAT" |   | No |
timeRange | String |   | Between hh:mm AM/PM to hh:mm AM/PM | No |
timezone | String | "UTC" | GMT +/-hh:mm | No |
startTime | String |   | dd/mm/yyyy hh:mm AM/PM | No |
endTime | String |   | dd/mm/yyyy hh:mm AM/PM | No |
description | String | Job name | Name of the job | Yes |
url | String | "null" or URL to monitor | The URL that you want to monitor. When you use this parameter, the value of the script | No |
script | String | "null" | If you have a scripted job, specify the python-based selenium script used for simulating the user flow or behavior. When you use this parameter, the value of the url | No |
apiMetadata | String | Script object of the web monitoring job |   | Yes |
contentType | String |   |   | Yes |
script | String |   |   | Yes |
browserCodes | String | Use the following Synthetic internal browser codes:
|   | No |
chromeVersions | String | Chrome browser version 86 |   | No |
locationCodes | String | Synthetic internal location codes of each agent location. See Location Codes. |   | Yes |
timeoutSeconds | Number |   |   | No |
appKey | String | Application key | You can get the application key from the Controller.
| Yes |
networkProfile | String |   | "name": "Native", "downloadKbps": 5000, "uploadKbps": 1000, "roundtripTimeMillis": 28, "packetLossPercent": 0, "isDefault": false | No |
composableConfig | - |   | You can use this parameter to configure:
| No |
numBeforeConfirmedError | Number | 0, 1, 2, 3, 5, or 10 | Number of retries | No |
resourceErrorDetection | - |   |   | No |
ignoreWhen | - |   |   | No |
resourceUrlContains | String | Comma-separated list | List of resource URLs | No |
resourceMimeType | String |   |   | No |
onlyWhen | - |   |   | No |
resourceUrlContains | String | Comma-separated list | List of resource URLs | No |
resourceMimeType | String |   |   | No |
deviceEmulationProfile | String |   |   | No |
requestHeader | String |   |   | No |
performanceCriteria | - |   |   | No |
retestOnWarning | Boolean | true or false | Re-test on warning event | No |
retestOnCritical | Boolean | true or false | Re-test on critical event | No |
warningCriterion | String |   |   | No |
criticalCriterion | String |   |   | No |
Response Status Codes
Code | Description |
---|---|
200 | Success |
401 | Unauthorized |
402 | Exceeded job limit |
422 | Validation failure |
429 | Throttled |
500 | Internal server error |