Release notes for ThousandEyes API v7.

API Changelog

The following list documents a running list of changes to version 7 of the ThousandEyes API. Each release date is linked to the specific release notes for that release. For details related to other versions of the ThousandEyes API, see the links on the left sidebar.

For more information, see the Product Changelog

September 21, 2026 - v7.0.107

  • Updated the Endpoint Tests API to return 409 Conflict when a duplicate name is used to create or update an agent-to-server scheduled test. The response returns the existing test ID in the message property of the errors item whose field is testId.
  • Updated PUT /streams/{id} so changing a stream destination requires replacing configured credentials. Omitted or redacted credentials are rejected when the destination changes. To remove existing custom headers, send customHeaders: {}.
  • Updated the Autonomous Systems API GET /v7/autonomous-systems/{asn}/prefixes operation to include the optional, read-only monitorCount field in expanded prefix associations. The field reports how many BGP monitors observed an announced association.

September 10, 2026 - v7.0.105

  • Updated the Endpoint Agents API response model to include agentExplainabilityFailures for data-collection failures and deploymentInfo for agent-reported deployment metadata. For more information, see EndpointAgent.
  • Updated the ThousandEyes for OpenTelemetry API to support excluding specific metrics and attributes from data streams with metricsFilter and attributesFilter. Supported filter values depend on the stream signal and data model version. For more information, see Filters.

September 3, 2026 - v7.0.104

  • Introduced the Endpoint Geolocation API with GET /v7/endpoint/geolocation/geonames to search for Endpoint Agent geographic locations by name.
  • Updated the BGP Updates API GET /v7/bgp/updates operation to use the deployed plural query filter names: prefixes, originAses, asPaths, rpkiStatuses, and monitorIds. Use these parameters when filtering BGP updates by prefix, origin AS, AS path, RPKI status, or monitor ID.
  • Removed the unsupported agentInterfaces field from HTTP Server, Page Load, and Web Transaction test configuration models. For supported Tests API and Instant Tests API operations, select an Enterprise Agent source interface with agents[].sourceIpAddress; supported test types are HTTP Server, Agent-to-Server, Agent-to-Agent source agents, FTP Server, SIP Server, and Voice.

August 24, 2026 - v7.0.102

  • Updated the Endpoint Agents API to return and filter agents by the embed-wireless-advantage and embed-wireless-essentials license types. These license types cannot be assigned through the update operation.
  • Updated the Endpoint Test Results API to include wirelessOnboarding timing metrics in local network topology results, reporting the duration of 802.11 authentication, 802.11 association, 802.1X authentication, and the EAPOL key handshake for Wi-Fi connection attempts.

August 20, 2026 - v7.0.101

  • Introduced the BGP Updates API with GET /v7/bgp/updates to retrieve paginated BGP updates observed by BGP monitors for prefixes tracked by your ThousandEyes account group.
  • Updated the Tests API and Instant Tests API to include the read-only sourceIpAddress field for each expanded test agent when a source interface is selected.

August 14, 2026 - v7.0.100

  • Updated the ThousandEyes for OpenTelemetry API to support durable data stream names. The optional name field can be supplied when creating or updating a stream and is returned by create, retrieve, update, and list operations; omitted names are generated on creation and preserved on update, and duplicate-name updates return 409 Conflict.
  • Added POST /v7/dashboards/{dashboardId}/clone to the Dashboards API to create a dashboard from an existing dashboard and optionally override settings including its title, layout, tags, refresh rate, saved filter, sharing, and default-dashboard settings. The operation does not inherit sharing settings and generates a unique duplicate title when title is omitted.
  • Added PUT /dashboards/{dashboardId}/actions/schedule and DELETE /dashboards/{dashboardId}/actions/schedule to the Dashboards API to create, update, or remove one-time or recurring dashboard snapshot schedules. Dashboard responses now include the read-only schedule field when a schedule exists. For more information, see ApiDashboard.
  • Updated Web Transaction console log result responses in the Test Results API to define ConsoleLogs.timestamp as an integer with int64 format. The value is Unix epoch time in milliseconds. For more information, see ConsoleLogs.

August 5, 2026

New

  • Released ThousandEyes Go SDK v3.0.0, the first generally available release of the Go SDK for the ThousandEyes API v7. The SDK supports cursor-based pagination, automatic retries, and error handling. For installation and usage information, see Libraries & SDKs.

August 3, 2026 - v7.0.99

July 28, 2026 - v7.0.98

Updates

  • Updated the Endpoint Agents API and Endpoint Test Results API to support exact, case-sensitive filtering by NIC model (nicModel) and NIC driver version (nicDriverVersion). The equivalent Tags filters remain exact and case-sensitive.

July 23, 2026 - v7.0.97

Updates

  • Updated the Event Detection API to support additional event types and related event response data. Event responses now include the read-only agentType field, and GET /events supports the ongoing query parameter to include or exclude active events.

July 22, 2026 - v7.0.96

New

  • Added PUT /cloud-insights/integration/azure/inventory/{integrationId} and PUT /cloud-insights/integration/azure/flow-logs/{integrationId} to the Cloud Insights Integrations API. These operations update existing Azure inventory monitoring and flow logs monitoring integrations.

Updates

July 1, 2026 - v7.0.94

New

Updates

  • Updated HTTP Server test results to include the dnsServerMeasurement object when DNS resolution details are available for a round. This object describes the DNS response used to resolve the target and any additional DNS responses observed during resolution.

June 25, 2026

New

  • Added the ThousandEyes CLI to Developer Resources. The CLI is built on top of the ThousandEyes API and provides a command-line option for managing API-backed workflows. For installation and usage details, see the ThousandEyes CLI GitHub repository.

June 18, 2026 - v7.0.92

New

  • Added GET /v7/agents/local-problems to the Agents API to return local problem intervals for Cloud Agents. Local problems indicate agent-side impairment detected by ThousandEyes and do not indicate that a monitored target or service was down.

Updates

  • Updated the Agents API (/agents) to return the serialNumber field for Enterprise Agents and Enterprise Agent cluster members when available. This field is not available for Cloud Agents. For more information, see EnterpriseAgentData.

June 11, 2026 - v7.0.91

Updates

  • Updated the Tags API to support filtering endpoint-agent tags by custom labels using the new scope field on TagFilter.
  • Updated the Endpoint Agents API to return normalized free storage (freeDiskSpaceNormalized), NIC driver version (nicDriverVersion), and NIC model (nicModel) on endpoint agents. For more information, see EndpointAgent.
  • BatteryMetrics now includes normalized battery health (batteryHealthNormalizedPercent) on endpoint agents and in endpoint test results. For more information, see BatteryMetrics and BatteryMetrics in Endpoint Test Results.
  • Updated the Endpoint Tests API to support selecting endpoint agents by tag IDs using agentSelectorType: agent-tags and tagIds. For more information, see EndpointTestAgentSelectorType.
  • Updated the Tags API to support filtering endpoint-agent tags by user-defined check-in metadata keys using the new scope field on TagFilter

June 4, 2026 - v7.0.90

Updates

  • Updated Page Load and Transaction test configuration to add the distributedTracing field. This enables B3 and W3C distributed tracing headers in test requests, consistent with API and HTTP Server tests. For more information, see PageLoadProperties and WebTransactionProperties.

May 28, 2026 - v7.0.89

Updates

  • HTTP Server tests now support the requestMethod field (get or post). For more information, see HttpServerProperties.

May 14, 2026 - v7.0.88

Updates

  • Updated the Endpoint Test Results API to include the meetingApp field in Dynamic Test network results for Webex meetings facilitated by RoomOS in CVI mode. Supported meeting apps include Microsoft Teams (VIMT), Webex, and Zoom CRC.

May 13, 2026 - v7.0.87

New

Updates

  • Updated the ThousandEyes for OpenTelemetry API to support Endpoint Agent tags. You can now include the endpointAgentTag field when creating or updating a data stream. The endpointAgentLabel and endpointAgentTag fields represent the same data and are synchronized automatically; configure only one.

April 22, 2026

Updates

April 21, 2026 - v7.0.83

Updates

April 1, 2026 - v7.0.81

Updates

  • Updated the Dashboards API to support tag-based filtering (labels compatibility) on dashboard resources, dashboard snapshot operations at /v7/dashboard-snapshots, and dashboard filter operations at /v7/dashboards/filters. Filter payloads may use tag field patterns *_TAG_ID (UUID), *_TAG_KEY, and *_TAG_VALUE:
    • Supported filter families include Network and Application Synthetics test and agent tags, Alerts test and agent tags, and Endpoint test and agent tags.
    • Legacy label filters remain supported on POST and PUT. Requests that include legacy label filters are accepted and converted internally to tag filters. If both legacy label filters and tag filters are provided, they are merged. Existing integrations that send label filters do not need immediate changes.
    • GET responses follow these rules:
      • If a legacy label mapping exists, the response includes both legacy label fields and tag-based filter fields.
      • If no legacy label mapping exists, the response includes tag-based fields only (for example, *_TAG_ID).
      • If a filter was saved using key/value semantics, the response includes *_TAG_KEY and *_TAG_VALUE and does not include legacy label fields.
    • For long-term compatibility and richer filtering semantics, use tag-based fields (*_TAG_ID, *_TAG_KEY, *_TAG_VALUE) when integrating.

February 5, 2026 - v7.0.75

Updates

  • The Filter endpoint agents supports filtering and sorting by serialNumber via the searchFilters parameter, and includes the device serial number in the response when available.

January 28, 2026 - v7.0.74

Updates

December 15, 2025 - v7.0.70

New

  • Introduced the new Cloud Insights Integrations API that provides automation-friendly workflows for onboarding cloud accounts and managing Cloud Insights integration settings.
    • The API allows you to fully manage AWS and Azure Inventory monitoring and Flow Logs Monitoring integrations using the ThousandEyes API. This API includes operations to:
      • Create AWS and Azure integrations for:
        • Inventory monitoring.
        • Flow logs monitoring.
      • List all existing AWS and Azure integrations for the authenticated account group.
      • Retrieve the full configuration of a specific integration.
      • Delete an existing integration.
      • Fetch required AWS IAM policies for inventory and flow logs monitoring integrations, including:
        • Trusted Policy.
        • Permissions Policy.
        • SNS Topic Access Policy (flow logs).

November 25, 2025 - v7.0.67

Updates

October 17, 2025 - v7.0.65

Updates

  • We've enhanced the Usage API to align the agentId field with the Agents API (/v7/agents/) for consistency across the platform.
    • The agentId field in Usage API responses now returns the same agentId used in the /v7/agents/ API. This change enables you to easily retrieve detailed agent information by using the agentId value from Usage API responses to call /v7/agents/{agentId}.
    • The unused vAgentId field has been removed from the API documentation, as it was not present in the actual response.
    • Affected Endpoints

October 10, 2025 - v7.0.64

New

September 09, 2025 - v7.0.62

Updates

  • Added ASN fields to Network Outage alerts, providing autonomous system details for affected networks.

September 03, 2025 - v7.0.60

New

  • Introduced the Integrations API for managing connectors and operations. This API includes operations to:
    • Create, retrieve, update, and delete generic connectors.
    • Create, retrieve, update, and delete webhook operations.
    • Assign and unassign connectors to operations.
    • Assign and unassign operations to connectors.

August 12, 2025 - v7.0.57

New

  • Added a new POST /api-tokens operation to regenerate your account's bearer token.

Updates

  • Added support for the userProfile object in the response body for HTTP Scheduled Test Results, Network Scheduled Test Results, and Dynamic Network Scheduled Test Results API operations. The object is returned when the expand=userProfile query parameter is included. Requires Endpoint Agent version 2.13.3 or later.

July 3, 2025 - 7.0.53

Updates

  • Updated the Local Network Endpoint Test Results API operations to add threshold filters.
  • Updated the Network Endpoint Scheduled Test Results API operations to add ZTA metrics and application score filters.

July 2, 2025 - 7.0.53

Updates

  • Renamed the /v7/stream path to /v7/streams. The previous path is still supported for backward compatibility.
  • Added regex matching support to post-request assertion operations in API tests.

June 18, 2025 - v7.0.49

New

## June 2, 2025 - v7.0.48

Updates

Deprecated

  • Deprecated the state and severity fields in the GET /alerts/{alertId} endpoint. These fields have been replaced by alertState and alertSeverity.

## May 28, 2025 - v7.0.46

Updates

  • Updated the API test and HTTP Server test configurations to add the distributedTracing field. This enables the inclusion of tracing headers in requests, supporting both B3 and W3C trace context standards.

    For more information, see ApiProperties and HttpServerBaseProperties.

May 23, 2025 - v7.0.45

New

  • Added a new GET /tests/{testId}/history operation to retrieve the version history of a test. If no limit is specified, the response returns up to 50 versions or the total number of available versions if fewer than 50 exist.

Updates

  • Updated the GET /tests/{testType}/{testId} operation for all Cloud and Enterprise Agent (CEA) test types to add support for an optional versionId query parameter. When provided, the API returns the test settings for the specified version.

Deprecated

April 30, 2025 - v7.0.43

Updates

  • Updated the Agents API with the following enhancements:
    • Added dedicated operations for assigning and unassigning tests to agents.
    • Extended the GET /v7/agents response to include test-related information.
    • Added support for filtering of agents by tag using query parameters in the GET /v7/agents operation.

March 26, 2025 - v7.0.41

Updates

  • Updated the EndpointTest object to add labels field. This field is used by Scheduled Tests, Dynamic Tests, and Instant Tests. Note that test labels are not currently supported for Instant Tests.

March 19, 2025 - v7.0.40

API Documentation Updates for Platform Naming and Navigation Menu Changes

  • As part of the Platform Renaming and Rebranding initiative, terminology updates have been made in the API documentation to align with changes in the user interface. These updates do not affect API functionality.

    • Saved Events are now referred to as Private Snapshots in the UI. A disclaimer has been added to relevant documentation sections to clarify this.
    • Cloud and Enterprise Agent Tests have been renamed to Network and Application Synthetics Tests in the UI. API documentation references have been updated accordingly.

These updates do not impact API operations, request parameters, or responses.

Updates

January 28, 2025 - v7.0.36

Updates

## December 19, 2024 - v7.0.34

### Updates

December 17, 2024 - v7.0.33

Updates

  • Updated the Dashboards API to add the following experience score metrics to DashboardMetric:
    • ENDPOINT_GATEWAY_AGENT_SCORE
    • ENDPOINT_GATEWAY_SCORE
    • ENDPOINT_GATEWAY_CONNECTION_SCORE
    • ENDPOINT_GATEWAY_PROXY_SCORE
    • ENDPOINT_GATEWAY_VPN_SCORE
    • ENDPOINT_AST_TEST_APPLICATION_SCORE
    • ENDPOINT_TEST_APPLICATION_SCORE
    • ENDPOINT_TEST_HTTP_APPLICATION_SCORE
  • Added rate limits to the Deploy template API operation. For more information, see Template Deployment Rate Limits.

December 11, 2024 - v7.0.31

Updates

  • Extended Local Network Topology APIs to optionally include top applications by CPU and memory usage in the system metric details. This data is not included by default and can be accessed using the ?expand=system-metric-detail query parameter. For more information, see ExpandLocalNetworkTopologyOptions.

November 26, 2024 - v7.0.29

New

  • Randomized Start Time for Tests

    You can now enable tests to use a randomized start time via the API. This feature is useful for environments with a large number of Cloud Agents or Enterprise Agents testing the same target. It reduces the concurrent load on targets by distributing test start times within a configurable interval. By default, this feature is disabled for all tests but can be enabled via the API when needed. For more information, see TestRandomizedStartTime.

Updates

  • Added OAuth2 authentication support for the API test type

November 19, 2024 - v7.0.28

Updates

  • Added a new field, resourceInclusion, to the Templates API. This field can be used in the template definition or deployment payload to specify which assets should be excluded during a template deployment.

October 25, 2024 - v7.0.26

Updates

  • Added a new field, throughput, to the Test Results API response for agent-to-agent test results. This field reports the measured throughput in Mbps for each test round. Note that throughput was previously included in the v6 API response but had not been documented until now.

October 8, 2024 - v7.0.25

Updates

  • Custom Webhook and ServiceNow Incident Management Integrations for Alert Rules:
    You can now assign Custom Webhook and ServiceNow Incident Management integration types to alert rules using the following API operations:

    This update enhances flexibility in managing notifications for alert rules.

  • Resolved an issue where incorrect Custom Webhook Integration IDs were displayed.

October 7, 2024 - v7.0.24

Updates

  • Updated the Templates API to introduce a new groupings property in the Template model. This property allows the grouping of related user inputs or tests when creating or updating a template. This grouping is for display purposes in the UI and does not affect template deployment. Supported resource types include tests and user-inputs. Grouped tests are displayed under a shared title in the template test list, while grouped user inputs are organized into sections within the Global Inputs area, using the provided title and description.

September 26, 2024 - v7.0.22

Updates

  • Updated the ThousandEyes for OpenTelemetry API to allow filtering data points by test type.vThis filtering can be set when creating or updating a Stream, and is only available via the API.

    For example, if a user is only interested in the HTTP test type and wants to exclude NETWORK or BGP layers, the filter can be configured as follows:

    "filters": {
  "testTypes": {
      "values": [
        "http_server"
      ]
  }
}

September 24, 2024

Updates

  • Updated the Tags API so you can now add or update the icon and description fields for tags.
    • Supported icon values: "LABEL", "CIRCLE", "TRIANGLE", "SQUARE", "STAR", "LIGHTNING_BOLT", "MAP_PIN", "DASHBOARD", "WEB_APPLICATION".
    • The description field is optional.

September 18, 2024

New

  • Configure Splunk HEC Exporter in ThousandEyes for OpenTelemetry:

    You can now configure the following fields in the Splunk HEC exporter stream: token, source, sourceType, and index. For more details, visit the Splunk integration guide.

    With the new capability to configure the Splunk HEC index, you can choose whether to export ThousandEyes telemetry data as events or metrics to Splunk. Learn more here.

    Additionally, setting the Splunk HEC token in customerHeaders["token"] is now deprecated. The token should be specified in exporterConfig.SplunkHec.token going forward. This functionality will be removed in 3 months.

Updates

  • Updated the Alerts API to support the AUTO window grouping for CEA Agents, enabling Adaptive Alerting.

    With the AUTO window grouping, you can now configure the sensitivityLevel parameter to control the alert sensitivity. The available options are:

    • LOW
    • MEDIUM (default)
    • HIGH

September 5, 2024

New

  • ThousandEyes for OpenTelemetry Introduces dataModelVersion v2: ThousandEyes for OpenTelemetry now supports dataModelVersion v2. As part of this update, ThousandEyes for OpenTelemetry now uses dataModelVersion v2 as the default version. Both dataModelVersion v1 and v2 remain available for use. For more details, refer to the ThousandEyes for OpenTelemetry Data Model documentation.

Updates

  • Updated the Usage API operation to add a new deviceAgentsIncluded field to the UsageQuota object. This field indicates the amount of allocated device agents (connected devices product) in the customer's contract.

August 30, 2024

New

Updates

  • Proxy Configuration for API Tests via ThousandEyes Public API: You can now configure proxy settings for API tests using the ThousandEyes public API, enabling successful testing of API targets behind a proxy. This update also introduces the ability to gather network metrics, including proxy loss, latency, and jitter, as well as visualize proxy server paths and details in your test results.
  • Updated the Dashboards API to add rate limit.

August 23, 2024

Updates

August 13, 2024

### New

  • AUTO Window Grouping Support now available for both Cloud and Enterprise Agents (CEA), and Endpoint Agents:
    • Cloud and Enterprise Agents: When selecting AUTO window grouping, you can now set the sensitivityLevel parameter to LOW, MEDIUM, or HIGH (default is MEDIUM).
    • Endpoint Agents: AUTO window grouping is automatically applied when you specify a sensitivityLevel parameter value.

August 6, 2024

New

July 30, 2024

### Updates

  • Updated the ThousandEyes for OpenTelemetry API to add a new DataModelVersion field to the Stream object. This field indicates the version of the data model used in the data stream, currently fixed at v1. This enhancement provides users with a clearer understanding of the data structure and the version of the data model in use.
  • Updated the Endpoint Test Results API with the following:
    • Added protocol, tcpPathTraceMode and udpPathTraceMode to the PathVisRoute object.
    • Added EndpointTestResultProtocol to differentiate the network protocol in the test results and the protocol configured in the test

July 26, 2024

### Updates

  • Updated the get alert rule operation GET /v7/alerts/rules/{ruleId} to now include custom webhook integrations under the customWebhook field in notifications. The operation now provides integration ID, type, name, and target URL for custom webhook integrations, in addition to existing webhook and third-party integrations under the notifications header.

July 22, 2024

### New

  • Added support for agentInterfaces, downloadLimit, dnsOverride, and oAuth to web-based CEA tests.

July 12, 2024

### Updates

  • Updated the supported assignment types for tags to include test, v-agent, endpoint-test, and dashboard. Additionally, updated the legacyId attribute type in TagInfo to number.

June 25, 2024

### New

June 14, 2024

### Updates

  • Labels to Tags Migration: Starting June 24, 2024, all existing labels in the ThousandEyes backend will be migrated to tags. When querying the v7 API (e.g., /v7/tags), labels will now appear as tags in the format key:value. For example, a label with the value webex will be displayed as webex:webex. Migrated labels will include a legacyID field in the API response, indicating their original label ID. Tags created natively will have an empty legacyID field. This migration affects CEA Tests, CEA Agents, Endpoint Scheduled Tests, and Dashboards, but not Endpoint Agents. Note that this change only impacts the API; the UI will continue to display labels as they are until tags are introduced in a future release.

June 11, 2024

Deprecated

  • The objectType field of the tagMatch in the creation of a stream for the ThousandEyes for OpenTelemetry API is now deprecated and will be removed after August 2024.

May 23, 2024

### Updates

  • The Emulation API now uses lowercase characters for the emulated device category values, such as desktop, laptop, phone, and tablet.
  • Added the testMatch array to the ThousandEyes for OpenTelemetry API, enabling direct association of ThousandEyes tests with a stream integration to simplify the setup process.

May 8, 2024

### New

March 26, 2024

### New

  • Templates API (formerly Test Templates API) is now available at /v7/templates

March 11, 2024

### New

  • New Dashboard API operation, at /v7/dashboards:
    • List dashboard filters: /v7/dashboards/filters
  • New Usage API operations, at /v7/usage:
    • Get enterprise agent usage: /v7/usage/units/enterprise-agents
    • Get cloud and enterprise agents units usage: /v7/usage/units/tests

March 4, 2024

### New

March 1, 2024

### Updates

  • Templates API (formerly Test Templates API) is temporarily unavailable. It is being updated to be in compliance with the rest of the ThousandEyes API

February 20, 2024

### New

  • New Test Results API operation, at /v7/endpoint-test-results:
    • Retrieve network scheduled test results from multiple tests: /v7/endpoint/test-results/scheduled-tests/network/filter

November 30, 2023

### New

October 27, 2023

### New

August 17, 2023

### New

July 24, 2023

### New

### Updates

  • The alertId attribute in the alerts and alertdetail API has been converted from an integer to a string. This update takes effect from 1st August, 2023.

May 11, 2023

### New

  • New ThousandEyes for OpenTelemetry API operations, at /v7/stream
  • New Test Template API operations, at /v7/tests/templates
  • New Tags API operations, at /v7/tags

February 14, 2023

### New

  • Added new attribute id in alert and alert details API response to represent 128-bit alphanumeric UUID of alert

Removed

  • Removed id attribute in alerts and alert detail API

January 13, 2023

Removed

  • Alert-Grid widget has now been removed from the platform and from snapshots

October 10, 2022

Deprecated

  • Reports v7 API is deprecated when dashboards and reports merge.

June 24, 2020

### New

  • Alert details operation now returns list of affected tests for network-outage alerts

April 28, 2020

### New

  • New alert operations added, at /v7/alerts, with support for Internet Insights outage alerts.

February 04, 2020

### New

  • New dashboard operations, at /v7/dashboard.

November 26, 2019

### Updates

  • Path visualization operation now returns complete data at once.

October 15, 2019

### Updates

  • Reports operations have been updated with new functionality and structure, at /v7/reports

October 01, 2019

### New

  • Preview for ThousandEyes API v7 launched.