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.


--appAn optional existing app ID. If specified, the app spec will be treated as a proposed update to the existing app.
--formatColumns for output in a comma-separated list. Possible values: ID, Spec.Name, DefaultIngress, ActiveDeployment.ID, InProgressDeployment.ID, Created, Updated
--help, -hHelp for this command
--no-headerReturn raw data with no headers
Default: false
--specPath to an app spec in JSON or YAML format. For more information about app specs, see (required)
doctl appsDisplay commands for working with apps

Global Flags

--access-token, -tAPI V2 access token
--api-url, -uOverride default API endpoint
--config, -cSpecify a custom config file
  • macOS: ${HOME}/Library/Application Support/doctl/config.yaml
  • Linux: ${XDG_CONFIG_HOME}/doctl/config.yaml
  • Windows: %APPDATA%\doctl\config.yaml
--contextSpecify a custom authentication context name
--output, -oDesired output format [text|json]
Default: text
--traceShow a log of network activity while performing a command
Default: false
--verbose, -vEnable verbose output
Default: false