How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ThousandEyes Agent to Agent Tests API

Agent to Agent test management operations

ThousandEyes Agent to Agent Tests API is one of 98 APIs that ThousandEyes publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Agent to Agent Tests. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 5 operations across 2 paths, and defines 67 schemas. It is described by OpenAPI 3.2.0, at version 7.0.100.

Requests are made against a single base URL, https://api.thousandeyes.com/v7.

5 operations 2 paths 67 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
7.0.100
Base URL
https://api.thousandeyes.com/v7
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

ThousandEyes Agent to Agent Tests API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — Bearer authentication token

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Agent to Agent Tests 5

Agent to Agent test management operations

GET
/tests/agent-to-agent
List Agent to Agent tests
getAgentToAgentTests 1 param → 200401403404429500502default
POST
/tests/agent-to-agent
Create Agent to Agent test
createAgentToAgentTest 2 params body → 201400401403404429500502
GET
/tests/agent-to-agent/{testId}
Get Agent to Agent test
getAgentToAgentTest 4 params → 200401403404429500502default
PUT
/tests/agent-to-agent/{testId}
Update Agent to Agent test
updateAgentToAgentTest 3 params body → 200400401403404429500502
DELETE
/tests/agent-to-agent/{testId}
Delete Agent to Agent test
deleteAgentToAgentTest 2 params → 204401403404429500502default

Schemas 67

The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are AgentToAgentProperties (15 properties), AlertRule (13 properties), UnexpandedInstantTest (11 properties), Link (8 properties). Each schema is shown below with its type and property counts.

AgentToAgentTestResponse
AgentToAgentTestProtocol
string
TestCreatedDate
string
UTC created date (ISO date-time format).
MonitorType
string
Type of monitor
TestCreatedBy
string
User that created the test.
TestLinks
object
A list of links that can be accessed to get more information
2 properties
AlertType
string
Type of alert being triggered. In multi-layered tests, this value represents the layer the alert relates to. See [Alert Details](https://developer.cisco.com/do…
TestAgentRequest
object
2 properties 1 required
TestPathTraceMode
string
Select inSession to perform the path trace within a TCP session.
TestInterval
integer
Interval between test runs in seconds.
TestLabel
object
3 properties
SelfLinks
object
A links object containing the self link.
1 property
TestBgpMonitors
array
Contains list of enabled BGP monitors.
SharedWithAccount
object
2 properties
Coordinates
object
Geographic coordinates for agent location.
2 properties
TestTag
object
3 properties
AlertRule
object
13 properties
UnexpandedAgentToAgentTest
BaseRequest
object
4 properties
AgentResponse
SimpleAgent
object
AlertRoundsViolationMode
string
exact requires the same agents to meet the threshold in consecutive rounds. auto is only enabled for CEA and Endpoint Scheduled test rules. The default is any.
AgentToAgentTestRequest
UnexpandedInstantTest
object
11 properties
AgentToAgentProperties
object
15 properties 1 required
TestType
string
This is a read only value, as test type is implicit in the test creation url.
UnauthorizedError
object
2 properties
InstantTest
TestDirection
string
Direction of the test, which affects how results are shown.
TestResults
array
Reference to the test results.
TestAgentsResponse
array
Contains list of agents.
TestRandomizedStartTime
boolean
Indicates whether agents should randomize the start time in each test round.
TestBgpMeasurements
boolean
Set to true to enable bgp measurements.
AlertDirection
string
Direction for applicable alert types (eg. path trace, End-to-End (Agent) etc.)
BaseTest
UnexpandedTest
object
3 properties
AgentToAgentTests
object
2 properties
ExpandTestOptions
string
Monitor
object
6 properties
TestAgentsRequest
array
Contains list of Agent IDs (get agentId from /agents endpoint).
TestRequest
1 required
TestPort
integer
Target port.
TestLabels
array
Labels to which the test is assigned. This field is not returned for Instant Tests.
RuleId
string
Unique ID of the rule.
TestFixedPacketRate
integer
Sets packets rate sent to measure the network in packets per second.
Enabled
boolean
Test is enabled.
TestMonitorsProperties
object
3 properties
Error
object
5 properties
AgentBase
object
3 properties
TestTags
array
Tags assigned to the test. Returned only when expand=tag is specified. This field is not returned for Instant Tests. For more information, see /tags.
CloudEnterpriseAgentType
string
Type of the agent.
TestSelfLink
TestDscp
string
DSCP label.
ValidationError
object
Severity
string
The severity of the alert.
TestNumPathTraces
integer
Number of path traces executed by the agent.
MonitorsRequest
object
1 property
TestUsePublicBgp
boolean
Indicate if all available public BGP monitors should be used, when ommited defaults to bgpMeasurements value.
AgentToAgentTest
AgentToAgentInstantTest
ValidationErrorItem
object
3 properties
SensitivityLevel
string
Used when roundsViolatingMode is set to auto. The default is medium. Higher sensitivity increases the likelihood of triggering alerts.
TestSharedAccounts
array
Link
object
A hyperlink from the containing resource to a URI.
8 properties 1 required
TestDscpId
string
DSCP ID [to see list for acceptable values](https://docs.thousandeyes.com/product-documentation/tests/dscp-options-in-network-tests)
NetworkProviderInfo
object
Information about the network provider that owns the agent's public IP prefix.
3 properties
NetworkProviderType
string
Classification of the agent's network provider.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

thousandeyes-agent-to-agent-tests-api-openapi.yml Raw ↑

Other APIs ThousandEyes publishes across the network.

ThousandEyes Account Groups API
ThousandEyes Agent Proxies API
ThousandEyes Agent to Agent Instant Tests API
ThousandEyes Agent To Server Endpoint Dynamic Tests API
ThousandEyes Agent to Server Endpoint Instant Scheduled Tests API
ThousandEyes Agent to Server Endpoint Scheduled Tests API
ThousandEyes Agent to Server Instant Tests API
ThousandEyes Agent to Server Tests API
ThousandEyes Alert Rules API
ThousandEyes Alert Suppression Windows API
ThousandEyes Alerts API
ThousandEyes API Instant Tests API
Where this information came from

This is an independent, third-party profile of ThousandEyes Agent to Agent Tests API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.