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 --output global flag and specify the JSON format.


The following example proposes an app spec from the file directory src/your-app.yaml for a new app:

doctl apps propose --spec src/your-app.yaml


Option Description
--app An optional existing app ID. If specified, App Platform treats the spec 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 the app spec reference (required)
Command Description
doctl apps Displays 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
--http-retry-max Set maximum number of retries for requests that fail with a 429 or 500-level error
Default: 5
--http-retry-wait-max Set the minimum number of seconds to wait before retrying a failed request
Default: 30
--http-retry-wait-min Set the maximum number of seconds to wait before retrying a failed request
Default: 1
--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