doctl apps propose

Go to Navigation


doctl apps propose [flags]




Reviews and validates an app specification for a new or existing app. The request returns some information about the proposed app, including app cost and upgrade cost. If an existing app ID is specified, the app spec is treated as a proposed update to the existing app.

Only basic information is included with the text output format. For complete app details including an updated app spec, use the JSON format.


Option Description
--app An optional existing app ID. If specified, the app spec will be treated as a proposed update to the existing app.
--format Columns for output in a comma-separated list. Possible values: ```ID, Spec.Name, DefaultIngress, ActiveDeployment.ID, InProgressDeployment.ID, Created, Updated`.
--help , -h Help for this command
--no-header Return raw data with no headers
Default: false
--spec Path to an app spec in JSON or YAML format. For more information about app specs, see (required)
Command Description
doctl apps Display commands for working with apps

Global Flags

Option Description
--access-token, -t API V2 access token
--api-url, -u Override default API endpoint
--config, -c Specify a custom config file
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--context Specify a custom authentication context name
--interactive Enable interactive behavior. Defaults to true if the terminal supports it (default false)
Default: false
--output, -o Desired output format [text|json]
Default: text
--trace Show a log of network activity while performing a command
Default: false
--verbose, -v Enable verbose output
Default: false