Sign in
latestOpenAPI 3.0.0zlibraw.githubusercontent.com2026-08-18288558922.3 KB

eb53f39272b0

kubernetes

Validate Kubernetes manifests without applying them

Validate Kubernetes manifests against the cluster with a server-side dry-run apply, without persisting anything. Each resource is reported on its own, so a rejected resource does not hide the outcome of the others. The dry-run runs with the permissions of the requesting user, so it also surfaces missing permissions. A resource living in a namespace created by another manifest of the same request is reported as failed, because the dry-run never persists that namespace. Access policy: authenticated

post/kubernetes/{id}/manifests/dry_run

Path parameters

idinteger required

Environment(Endpoint) identifier

Request body

manifestsstring[]

The manifests to validate. Each entry may hold several YAML documents separated by "---".

namespacestring

The namespace applied to namespaced resources that do not declare one. A resource declaring a different namespace is rejected.

Example request

{
  "manifests": [
    "apiVersion: v1\nkind: ConfigMap\nmetadata:\n  name: app-config"
  ],
  "namespace": "default"
}

Response

Success

Example response

{
  "results": [
    {
      "kind": "ConfigMap",
      "name": "app-config",
      "namespace": "default",
      "status": "pass"
    }
  ]
}