Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Envoy Proxy Secret Discovery API

Secret Discovery Service (SDS) endpoints for dynamically discovering TLS certificates and keys.

Envoy Proxy Secret Discovery API is one of 25 APIs that Envoy Proxy publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Secret Discovery. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a GitHub repository, a changelog, and an API reference.

This API exposes 1 operation across 1 path, and defines 3 schemas. It is described by OpenAPI 3.1.0, at version 1.38.0.

Requests are made against a single base URL, http://localhost:9901.

1 operations 1 paths 3 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.38.0
Server
http://localhost:9901
License
Resource Areas
1

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Secret Discovery 1

Secret Discovery Service (SDS) endpoints for dynamically discovering TLS certificates and keys.

POST
/v3/discovery:secrets
Envoy Proxy Secret Discovery Service (SDS)
discoverSecrets body → 200

Schemas 3

The contract defines 3 schemas that model the data the API accepts and returns. The most detailed are DiscoveryRequest (6 properties), Node (6 properties), DiscoveryResponse (5 properties). Each schema is shown below with its type and property counts.

Node
object
Identifies the Envoy instance making a discovery request. Contains metadata about the proxy node including its identity, cluster membership, locality, and buil…
6 properties
DiscoveryResponse
object
A response from the management server containing xDS resources. The resources are encoded as protobuf Any messages and identified by their type URL.
5 properties
DiscoveryRequest
object
A request from an Envoy instance to the management server for xDS resources. Contains the node identity, requested resource names, the type URL of the resource…
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

envoy-proxy-secret-discovery-api-openapi.yml Raw ↑

Other APIs Envoy Proxy publishes across the network.

Envoy Proxy Rate Limit Service API
Envoy Proxy Health Discovery Service API
Envoy Proxy gRPC Access Log Service API
Envoy Proxy External Processing API
Envoy Proxy External Authorization API
Envoy Proxy Metrics Service API
Envoy Proxy Tap Service API
Envoy Proxy Certificates API
Envoy Proxy Cluster Discovery API
Envoy Proxy Clusters API
Envoy Proxy Configuration API
Envoy Proxy Debugging API