# ThousandEyes Tags API

**Canonical:** https://apis.io/apis/thousandeyes/thousandeyes-tags-api/  
**Provider:** ThousandEyes — https://apis.io/providers/thousandeyes/  
**Base URL:** https://api.thousandeyes.com/v7  
**Documentation:** https://developer.cisco.com/docs/thousandeyes/tags-api-overview/

ThousandEyes Tags API is one of 26 APIs that [ThousandEyes](https://apis.io/providers/thousandeyes/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Tags and Tag Assignment. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

The ThousandEyes Tags API provides a tagging system with key/value pairs. It allows you to tag assets within the ThousandEyes platform (such as agents, tests, or dashboards) with meaningful metadata. For example: `branch:sfo`, `branch:nyc`, and `team:netops`. This feature provides: * Support for automation. * Powerful and flexible reports/dashboards. * Support for third-party integrations. Things to note with the ThousandEyes Tags API: * Tags are backwards-compatible with existing labels. * Tags are separated by Tests (CEA), Agents (CEA), Endpoint Agents, Scheduled Endpoint Tests, and Reports. A single tag can only apply to one type of target object, so each tag must specify the target type of object via a `type` field. * Tags are defined in a single table so that they can be represented using a single model - `Tag`.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/thousandeyes/refs/heads/main/openapi/thousandeyes-tags-openapi.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/thousandeyes/refs/heads/main/overlays/thousandeyes-tags-overlay.yaml
- **APIReference** — https://developer.cisco.com/docs/thousandeyes/tags-api-overview/

## Other ThousandEyes APIs (12)

- [ThousandEyes Administrative API](https://apis.io/apis/thousandeyes/thousandeyes-administrative-api/)
- [ThousandEyes API Token Management API](https://apis.io/apis/thousandeyes/thousandeyes-api-token-management-api/)
- [ThousandEyes Agents API](https://apis.io/apis/thousandeyes/thousandeyes-agents-api/)
- [ThousandEyes Alerts API](https://apis.io/apis/thousandeyes/thousandeyes-alerts-api/)
- [ThousandEyes Autonomous Systems API](https://apis.io/apis/thousandeyes/thousandeyes-autonomous-systems-api/)
- [ThousandEyes BGP Monitors API](https://apis.io/apis/thousandeyes/thousandeyes-bgp-monitors-api/)
- [ThousandEyes Cloud Insights Integrations API](https://apis.io/apis/thousandeyes/thousandeyes-cloud-insights-integrations-api/)
- [ThousandEyes Credentials API](https://apis.io/apis/thousandeyes/thousandeyes-credentials-api/)
- [ThousandEyes Dashboards API](https://apis.io/apis/thousandeyes/thousandeyes-dashboards-api/)
- [ThousandEyes Emulation API](https://apis.io/apis/thousandeyes/thousandeyes-emulation-api/)
- [ThousandEyes Endpoint Agents API](https://apis.io/apis/thousandeyes/thousandeyes-endpoint-agents-api/)
- [ThousandEyes Endpoint Instant Scheduled Tests API](https://apis.io/apis/thousandeyes/thousandeyes-endpoint-instant-scheduled-tests-api/)

## Tags

Tags, Tag Assignment

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/thousandeyes/thousandeyes-tags-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/thousandeyes/.