# APIClarity Plugins Telemetry API

**Canonical:** https://apis.io/apis/apiclarity/apiclarity-plugins-telemetry-api/  
**Provider:** APIClarity — https://apis.io/providers/apiclarity/  
**Base URL:** https://apiclarity-server/api  
**Documentation:** https://github.com/openclarity/apiclarity/tree/master/plugins/api

APIClarity Plugins Telemetry API is one of 11 APIs that [APIClarity](https://apis.io/providers/apiclarity/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Telemetry, Traffic Capture, and Plugins. The published artifact set on APIs.io includes an OpenAPI specification, authentication docs, API documentation, and a GitHub repository.

The Swagger 2.0 contract every APIClarity traffic-source plugin implements to push captured traffic into a deployment — POST /telemetry, GET /hostsToTrace and POST /control/newDiscoveredAPIs. Authenticated with the optional X-Trace-Source-Token header issued when a trace source is registered. Implemented by the Istio WASM filter, the tap DaemonSet, and the Kong, Tyk, Kuma and OpenTelemetry Collector plugins.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| POST | `/telemetry` | Post an http telemetry |
| GET | `/hostsToTrace` | Get a list of hosts to trace |
| POST | `/control/newDiscoveredAPIs` | Allows a client to notify APIClarity about new APIs. |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/apiclarity/refs/heads/main/openapi/apiclarity-plugins-telemetry-swagger.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/apiclarity/refs/heads/main/overlays/apiclarity-plugins-telemetry-swagger-overlay.yaml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/apiclarity/refs/heads/main/authentication/apiclarity-authentication.yml
- **Documentation** — https://github.com/openclarity/apiclarity/tree/master/plugins
- **GitHubRepository** — https://github.com/openclarity/apiclarity

## Other APIClarity APIs (10)

- [APIClarity API Events API](https://apis.io/apis/apiclarity/apiclarity-api-events-api/)
- [APIClarity API Inventory API](https://apis.io/apis/apiclarity/apiclarity-api-inventory-api/)
- [APIClarity Control API](https://apis.io/apis/apiclarity/apiclarity-control-api/)
- [APIClarity Features API](https://apis.io/apis/apiclarity/apiclarity-features-api/)
- [APIClarity BFLA Module API](https://apis.io/apis/apiclarity/apiclarity-bfla-module-api/)
- [APIClarity Fuzzer Module API](https://apis.io/apis/apiclarity/apiclarity-fuzzer-module-api/)
- [APIClarity Trace Analyzer Module API](https://apis.io/apis/apiclarity/apiclarity-trace-analyzer-module-api/)
- [APIClarity Spec Differ Module API](https://apis.io/apis/apiclarity/apiclarity-spec-differ-module-api/)
- [APIClarity Spec Reconstructor Module API](https://apis.io/apis/apiclarity/apiclarity-spec-reconstructor-module-api/)
- [APIClarity Notifications API](https://apis.io/apis/apiclarity/apiclarity-notifications-api/)

## Tags

Telemetry, Traffic Capture, Plugins

---

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