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
On this page
v0.14.0
- 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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
And 9 more in this version.
v0.13.0
- 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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
And 1,805 more in this version.
v0.12.0
- 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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
v0.11.0
- 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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 - 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
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, or have your coding agent call check_code with your manifest or lockfile over MCP. The 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.
See how out of date your code is.
Tell your agent what changed since it was trained.
claude mcp add --transport http since https://api.since.dev/mcpCodex, Cursor and any MCP client use https://api.since.dev/mcp.