Create a new snapshot

POST https://{{base_url}}/v6/snapshot.json

Create a new snapshot

Creates a new snapshot in ThousandEyes, based on properties provided in the POST data. This endpoint requires the Create snapshot shares permission be assigned to the role of the user accessing this endpoint.

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

Important notes related to snapshot creation using this endpoint: * There is a creation limit of 100 snapshots per Organization per day. * Snapshots created using this endpoint will expire after 30 days. * The time range specified with from and to must be one of the following: 1, 2, 4, 6, 12, 24, 48, 96 hours.

Optional (Querystring) Parameters

• format=json|xml optional, specifies the format of output requested. See Output Formats for more information
• 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

• request body containing the following fields:
  • displayName string Required n/a Title of the snapshot
  • from dateTime Required yyyy-MM-dd hh:mm:ss The date/time when the snapshot will start
  • isPublic integer Optional n/a 0 for saved event, 1 for share link. Defaults to 0
  • testId integer Required n/a The ID of the test you wish to create a snapshot
  • to dateTime Required yyyy-MM-dd hh:mm:ss The date/time when the snapshot will end

HEADERS