Account group context

API requests are handled within the context of an account group. If your user is assigned to only one account group, you do not need to specify an account group in your requests.

Specifying an Account Group

If your user is assigned to multiple account groups, the default account group context is your login account group. To access a different account group, you must specify the account group ID in your API request by using the aid URL query parameter. A list of account group IDs can be found using the Account group list endpoint.

In the two curl commands given below, the first command retrieves a list of all tests within the login account group, whereas the second command fetches a list of all tests from the account group possessing the ID 123456. Note that for the sake of brevity, authentication is omitted from this example.

curl https://api.thousandeyes.com/v7/tests

curl https://api.thousandeyes.com/v7/tests?aid=123456