--- title: "github.com/envoyproxy/go-control-plane (go) | Since.dev" description: "What each github.com/envoyproxy/go-control-plane release removed, renamed or changed: 2,086 breaking changes in 4 versions on Go modules, each with its source." canonical_url: https://since.dev/packages/go/github.com/envoyproxy/go-control-plane last_updated: 2025-11-04 --- # github.com/envoyproxy/go-control-plane breaking changes Every breaking API change we have recorded in github.com/envoyproxy/go-control-plane on Go modules: 2,086 breaking changes in 4 versions. Below are its newest 4 versions, removals and renames first, each with its source. Newest change November 4, 2025 ## v0.14.0 19 breaking changes, first published November 4, 2025. - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.DeltaResponseWatch.StreamState` github.com/envoyproxy/go-control-plane/pkg/cache/v3.DeltaResponseWatch.StreamState was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.LinearCache.NumDeltaWatches` github.com/envoyproxy/go-control-plane/pkg/cache/v3.LinearCache.NumDeltaWatches was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.NextVersionMap` github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.NextVersionMap was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.RemovedResources` github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.RemovedResources was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.Resources` github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawDeltaResponse.Resources was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawResponse.Resources` github.com/envoyproxy/go-control-plane/pkg/cache/v3.RawResponse.Resources was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/server/stream/v3.NewStreamState` github.com/envoyproxy/go-control-plane/pkg/server/stream/v3.NewStreamState was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/server/stream/v3.StreamState` github.com/envoyproxy/go-control-plane/pkg/server/stream/v3.StreamState was removed in github.com/envoyproxy/go-control-plane v0.14.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.Cache.CreateDeltaWatch` Was func CreateDeltaWatch(\*DeltaRequest, stream.StreamState, chan DeltaResponse) (func()); now func CreateDeltaWatch(\*DeltaRequest, Subscription, chan DeltaResponse) (func(), error). [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/cache/v3.Cache.CreateWatch` Was func CreateWatch(\*Request, stream.StreamState, chan Response) (func()); now func CreateWatch(\*Request, Subscription, chan Response) (func(), error). [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.14.0) And 9 more in this version. ## v0.13.0 1,815 breaking changes, first published August 15, 2024. - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/action/v3.File_contrib_envoy_extensions_filters_network_generic_pr...` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/action/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_action_v3_action_proto was removed... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/codecs/dubbo/v3` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/codecs/dubbo/v3 was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/matcher/v3.File_contrib_envoy_extensions_filters_network_generic_p...` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/matcher/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_matcher_v3_matcher_proto was... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/router/v3` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/router/v3 was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_v3_...` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_v3_generic_proxy_proto was removed in... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_v3_...` github.com/envoyproxy/go-control-plane/contrib/envoy/extensions/filters/network/generic_proxy/v3.File_contrib_envoy_extensions_filters_network_generic_proxy_v3_route_proto was removed in... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/credential_injector/v3.CredentialInjector.FailIfNotPresent` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/credential_injector/v3.CredentialInjector.FailIfNotPresent was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/credential_injector/v3.CredentialInjector.GetFailIfNotPresent` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/credential_injector/v3.CredentialInjector.GetFailIfNotPresent was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/ext_proc/v3.ExternalProcessor.AsyncMode` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/ext_proc/v3.ExternalProcessor.AsyncMode was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/ext_proc/v3.ExternalProcessor.GetAsyncMode` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/ext_proc/v3.ExternalProcessor.GetAsyncMode was removed in github.com/envoyproxy/go-control-plane v0.13.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.13.0) And 1,805 more in this version. ## v0.12.0 10 breaking changes, first published January 2, 2024. - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAdd` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAdd was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAddMultiError` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAddMultiError was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAddValidationError` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip_GeolocationHeadersToAddValidationError was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip.GeoHeadersToAdd` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip.GeoHeadersToAdd was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip.GetGeoHeadersToAdd` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/http/geoip/v3.Geoip.GetGeoHeadersToAdd was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Removed** `github.com/envoyproxy/go-control-plane/pkg/server/v3.Server.discoverygrpc.AggregatedDiscoveryServiceServer` github.com/envoyproxy/go-control-plane/pkg/server/v3.Server.discoverygrpc.AggregatedDiscoveryServiceServer was removed in github.com/envoyproxy/go-control-plane v0.12.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/client/sotw/v3.Response.Resources` Was Resources \[\]\*any.Any; now Resources \[\]\*anypb.Any. [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/server/delta/v3.NewServer` Was func NewServer(context.Context, cache.ConfigWatcher, Callbacks) Server; now func NewServer(context.Context, cache.ConfigWatcher, Callbacks, ...config.XDSOption) Server. [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/server/sotw/v3.NewServer` Was func NewServer(context.Context, cache.ConfigWatcher, Callbacks) Server; now func NewServer(context.Context, cache.ConfigWatcher, Callbacks, ...config.XDSOption) Server. [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) - **Signature changed** `github.com/envoyproxy/go-control-plane/pkg/server/v3.NewServer` Was func NewServer(context.Context, cache.Cache, Callbacks) Server; now func NewServer(context.Context, cache.Cache, Callbacks, ...config.XDSOption) Server. [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.12.0) ## v0.11.0 242 breaking changes, first published January 30, 2023. - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfig` github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfig was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfigMultiError` github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfigMultiError was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfigValidationError` github.com/envoyproxy/go-control-plane/envoy/config/cluster/v3.UpstreamBindConfigValidationError was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteAction.GetPathTemplateRewrite` github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteAction.GetPathTemplateRewrite was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteAction.PathTemplateRewrite` github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteAction.PathTemplateRewrite was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteMatch_PathTemplate` github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteMatch_PathTemplate was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteMatch.GetPathTemplate` github.com/envoyproxy/go-control-plane/envoy/config/route/v3.RouteMatch.GetPathTemplate was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/cache/simple_http_cache/v3` github.com/envoyproxy/go-control-plane/envoy/extensions/cache/simple_http_cache/v3 was removed in github.com/envoyproxy/go-control-plane v0.11.0 [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/network/meta_protocol_proxy/matcher/action/v3.File_envoy_extensions_filters_network_meta_protoco...` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/network/meta_protocol_proxy/matcher/action/v3.File_envoy_extensions_filters_network_meta_protocol_proxy_matcher_action_v3_action_proto... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) - **Removed** `github.com/envoyproxy/go-control-plane/envoy/extensions/filters/network/meta_protocol_proxy/matcher/v3.File_envoy_extensions_filters_network_meta_protocol_proxy...` github.com/envoyproxy/go-control-plane/envoy/extensions/filters/network/meta_protocol_proxy/matcher/v3.File_envoy_extensions_filters_network_meta_protocol_proxy_matcher_v3_matcher_proto was removed... [pkg.go.dev](https://pkg.go.dev/github.com/envoyproxy/go-control-plane@v0.11.0) And 232 more in this version. ## Check your code These are the changes. To see which of them reach your code, [scan a public repository](https://since.dev/scan.md), or have your coding agent call `check_code` with your manifest or lockfile over [MCP](https://since.dev/docs.md#mcp). [The API](https://since.dev/docs.md#api) reads every change in every version, not only the newest. A fix pull request opens for the changes that reach a connected repository. Nothing merges or deploys. ## Put your code on continuous maintenance. Scan a public repository now, or give your agent one line. [Scan a repository](https://since.dev/scan.md). Any public GitHub repository. No sign-in. ### Tell your agent what changed since it was trained. `claude mcp add --transport http since https://api.since.dev/mcp` [Get an API key](https://app.since.dev/login?mode=signup) Codex, Cursor and any MCP client use https://api.since.dev/mcp. --- Every page on this site as Markdown: https://since.dev/sitemap.md. For agents: https://since.dev/llms.txt.