overlay: 1.0.0
info:
title: API Evangelist enhancements for Kubernetes API
version: 1.0.0
extends: openapi/kubernetes-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-provider: kubernetes
x-apievangelist-tags:
- Cloud Native
- CNCF
- Orchestration
- Containers
x-apievangelist-artifacts:
packages: packages/kubernetes-packages.yml
authentication: authentication/kubernetes-authentication.yml
conventions: conventions/kubernetes-conventions.yml
errors: errors/kubernetes-problem-types.yml
lifecycle: lifecycle/kubernetes-lifecycle.yml
data-model: data-model/kubernetes-data-model.yml
cli: cli/kubernetes-cli.yml
changelog: changelog/kubernetes-changelog.yml
- target: $.info
update:
x-apievangelist-error-model: >-
Errors are returned as a Kubernetes Status object (kind: Status,
status: Failure) carrying an HTTP code, a machine-readable reason,
and a human-readable message — not RFC 9457 problem+json.
- target: $.components.securitySchemes
update:
x-apievangelist-auth-note: >-
Bearer tokens are service-account or user JWTs issued by the cluster;
client-certificate auth is mutual TLS against the cluster CA. Real
clusters also support OIDC and webhook token authentication.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.