kongctl diff konnect

Uses: kongctl
Related Documentation
Related Resources

Show Konnect configuration differences.

Command usage

Usage:
  kongctl diff konnect [flags]

Aliases:
  konnect, k, K

Examples:
  # Preview changes from declarative configuration
  kongctl diff -f api.yaml
  
  # Preview changes using the explicit Konnect target form
  kongctl diff konnect -f api.yaml
  
  # Display differences from an existing plan artifact
  kongctl diff --plan plan.json


Flags:
      --base-dir string                   Base directory boundary for !file resolution.
                                          Defaults to each -f source root (file: its parent dir, dir: the directory itself). For stdin and URLs, defaults to CWD.
                                          - Config path: [ konnect.declarative.base-dir ]
      --base-url string                   Base URL for Konnect API requests.
                                          - Config path: [ konnect.base-url ]
                                          - Default   : [ https://us.api.konghq.com ]
      --color-theme string                Configures the CLI UI/theme (prompt, tables, TUI elements).
                                          - Config path: [ color-theme ]
                                          - Examples   : [ auto, 3024_day, 3024_night, aardvark_blue, abernathy ]
                                          - Reference  : [ https://github.com/lrstanley/bubbletint/blob/master/DEFAULT_TINTS.md ] (default "auto")
      --config-file string                Path to the configuration file to load.
                                          - Default: [ $XDG_CONFIG_HOME/kongctl/config.yaml ]
  -f, --filename strings                  File, directory, URL, or '-' to use to create the resource (can specify multiple)
      --full-content                      Display full content for large fields instead of summary
  -h, --help                              help for konnect
      --http-retry-backoff-factor float   Exponential backoff growth factor for retries (for example: 2.0).
                                          - Config path: [ konnect.http-retry-backoff-factor ]
      --http-retry-initial-interval int   Initial retry backoff interval in milliseconds (0 = use default).
                                          - Config path: [ konnect.http-retry-initial-interval ]
      --http-retry-max-attempts int       Maximum total attempts for retryable HTTP requests (0 = use default, 1 disables retries).
                                          - Config path: [ konnect.http-retry-max-attempts ]
      --http-retry-max-interval int       Maximum retry backoff interval in milliseconds (0 = use default).
                                          - Config path: [ konnect.http-retry-max-interval ]
      --http-retry-on-connection-errors   Retry selected retryable connection-level errors.
                                          - Config path: [ konnect.http-retry-on-connection-errors ]
      --log-file string                   Write execution logs to the specified file instead of STDERR.
                                          - Config path: [ log-file ]
      --log-level string                  Configures the logging level. Execution logs are written to STDERR.
                                          - Config path: [ log-level ]
                                          - Allowed    : [ trace|debug|info|warn|error ] (default "error")
      --mode string                       Diff mode (sync|apply|delete) (default "sync")
      --no-telemetry                      Disable telemetry for this command invocation. Overrides config and env.
                                          - Config path: [ telemetry.enabled ]
                                          - Env var    : [ KONGCTL_NO_TELEMETRY ]
                                          - Default    : [ false ]
  -o, --output string                     Configures the format of data written to STDOUT.
                                          - Config path: [ output ]
                                          - Allowed    : [ json|yaml|text ] (default "text")
      --pat string                        Konnect Personal Access Token (PAT) used to authenticate the CLI. 
                                          Setting this value overrides tokens obtained from the login command.
                                          - Config path: [ konnect.pat ]
      --plan string                       Path to existing plan file to display
  -p, --profile string                    Specify the profile to use for this command. (default "default")
  -R, --recursive                         Process the directory used in -f, --filename recursively
      --region string                     Konnect region identifier (for example "eu"). Used to construct the base URL when --base-url is not provided.
                                          - Config path: [ konnect.region ]
      --remote-file-auth string           Authentication mode for remote -f URL sources (auto|none).
                                          In auto mode, kongctl sends the current Konnect bearer token only to HTTPS Konnect hosts.
                                          - Config path: [ konnect.declarative.remote-file-auth ] (default "auto")
  -s, --remote-file-save-dir string       Save remote -f URL sources into this local directory before loading
  -F, --remote-file-save-force            Overwrite existing files when saving remote -f URL sources with --remote-file-save-dir
      --require-any-namespace             Require explicit namespace on all resources (via kongctl.namespace or _defaults.kongctl.namespace).
                                          Cannot be used with --require-namespace.
                                          - Config path: [ konnect.declarative.require-any-namespace ]
      --require-namespace strings         Require specific namespaces. Accepts comma-separated list or repeated flags.
                                          Cannot be used with --require-any-namespace.
                                          Examples:
                                            --require-namespace=foo                          # Allow only 'foo' namespace
                                            --require-namespace=foo,bar                      # Allow 'foo' or 'bar' (comma-separated)
                                            --require-namespace=foo --require-namespace=bar  # Allow 'foo' or 'bar' (repeated flags)
                                          - Config path: [ konnect.declarative.require-namespace ]
      --text-id-format string             Configure UUID rendering in static text-table ID columns.
                                          - Config path: [ text.id-format ]
                                          - Allowed    : [ compact|full ]
                                          - Default    : [ compact ]
      --text-layout string                Configure static text-table column selection.
                                          - Config path: [ text.layout ]
                                          - Allowed    : [ compact|auto|wide ]
                                          - Default    : [ compact ]
      --write-secret stringArray          Write configured secrets selected by [resource-type:]resource-ref[#field] (repeatable)
      --write-secrets                     Write all eligible configured write-only secrets, warning when fields are skipped

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!