Creating a test

POST https://{{base_url}}/v6/tests/{{testType}}/new.json

Creating a test

Creates a new test in ThousandEyes, based on properties provided in the POST data. In order to create a new test, the user attempting the creation must be an Account Admin.

Regular users are blocked from using any of the POST-based methods.

Note: When creating or updating a test and assigning alert rules, that alert rules are based on specific measurements being available. For example, when creating an HTTP server test with network measurements disabled, you will not be able to assign any alert rules that are based on network metrics. The same applies to BGP measurements.

Optional (Querystring) Parameters

• aid={aid} optional and requires the user to be assigned to the target account group, specifies the account group context of the request, obtained from the /account-groups endpoint. Specifying this parameter without the user being assigned to the target account will result in an error response. See Account group context for more information

Request

• {testType} corresponds to any of the following options:
  • agent-to-server
  • agent-to-agent
  • bgp
  • http-server
  • page-load
  • transactions
  • web-transactions
  • ftp-server
  • dns-trace
  • dns-server
  • dns-dnssec
  • dnsp-domain
  • dnsp-server
  • sip-server
  • voice (RTP Stream)
• Request body should contain fields to be set during creation. See the Test Metadata page for fields available during test creation.

HEADERS