Give Feedback

doctl apps propose

Generated on 20 Oct 2025 from doctl version v1.146.0

Usage

doctl apps propose [flags]

Aliases

Description

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.

Example

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

Flags

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 Default:
`--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`