SitesSynthetic Tests

triggerSiteSyntheticTest

POST
/api/v1/sites/{site_id}/synthetic_test

Trigger Synthetic Testing

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

site_id*string
Formatuuid

Request Body

application/json

Request body for triggering a site synthetic test

email?string

Contact email address supplied when triggering the site synthetic test

Formatemail

Response Body

curl -X POST "https://example.com/api/v1/sites/000000ab-00ab-00ab-00ab-0000000000ab/synthetic_test" \  -H "Content-Type: application/json" \  -d '{    "email": "test@mist.com"  }'
{  "id": "a42775f6-edc8-69b5-f979-542fa1b43ff9",  "message": "Successfully queued synthetic test for the site.",  "status": "string"}