API definitions for the Istio project

api

Go to file

Francisco Herrera 87475465cd feat: add spaceDelimitedClaims field to RequestAuthentication API (#3547 ) Signed-off-by: Francisco Herrera <fjglira@gmail.com>		2025-09-22 20:44:28 -07:00
.devcontainer	…
.github	…
analysis/v1alpha1	…
annotation	…
common	…
common-protos	…
dictionaries	…
envoy	…
extensions/v1alpha1	…
kubernetes	…
label	…
licenses	…
mcp	…
mesh/v1alpha1	…
meta/v1alpha1	…
networking	…
releasenotes	feat: add spaceDelimitedClaims field to RequestAuthentication API (#3547 )	2025-09-22 20:44:28 -07:00
scripts	Update mesh config to not import k8s libraries (#3154 )	2024-05-20 11:56:31 -04:00
security	…
stability	…
telemetry	…
tests	…
type/v1beta1	…
.gitattributes	Automator: update common-files@master in istio/api@master (#3076 )	2024-01-31 15:44:40 -08:00
.gitignore	Automator: update common-files@master in istio/api@master (#1317 )	2020-03-09 11:38:10 -07:00
BUGS-AND-FEATURE-REQUESTS.md	…
CODEOWNERS	fix CODEOWNERS (#2489 )	2022-09-29 06:29:07 -07:00
CONTRIBUTING.md	Import common files into this repo (#935 )	2019-05-30 20:36:13 -07:00
GUIDELINES.md	…
LICENSE	Automator: update common-files@master in istio/api@master (#2981 )	2023-10-31 10:54:28 -07:00
Makefile	Automator: update common-files@master in istio/api@master (#3277 )	2024-07-23 10:25:32 -04:00
Makefile.core.mk	Update mesh config to not import k8s libraries (#3154 )	2024-05-20 11:56:31 -04:00
Makefile.overrides.mk	…
README.md	…
SUPPORT.md	…
buf.gen-golang.yaml	buf: migrate to v1 API (#2297 )	2022-03-25 06:19:22 -07:00
buf.gen-noncrd.yaml	…
buf.gen.yaml	Generate alias for types instead of copies (#3188 )	2024-05-20 11:48:31 -04:00
buf.yaml	…
clean.sh	…
gen.sh	…
go.mod	…
go.sum	Run with latest build container (#3552 )	2025-08-19 03:35:16 -04:00
google	Move protobuf generation/configuration to buf (#1833 )	2021-01-28 17:47:43 -08:00
header.go.txt	…
istio.io	Move protobuf generation/configuration to buf (#1833 )	2021-01-28 17:47:43 -08:00

README.md

Istio APIs and Common Configuration Definitions

This repository defines component-level APIs and common configuration formats for the Istio platform. These definitions are specified using the protobuf syntax.

This repository depends only on the tools repository for tools used during build. This repository will not depend on any other repositories. Except for tools, all other Istio repositories can take a dependency on the api repository.

API Guidelines

When making changes to the protos in this repository, your changes must comply with the API guidelines.

Updating

After the protobuf definitions are updated, the corresponding *pb.go, _pb2.py, *.json and Kubernetes Custom Resource Definition files must be generated by running make gen and submitted as part of the same PR as the updated definitions. Also make gen will update the proto.lock file with new changes.

Backwards Incompatible Changes

If a PR tries to make backwards incompatible changes, it will be blocked by buf breaking. If there are legitimate reasons to make these breaking changes forever, the configuration in buf.yaml can be changed. If it is a one-off case, the PR can be force approved skipping the test.