Deployment errors

A deployment error identifies a rejected request or a failed runtime stage. Read the response with the repository, selected source, manifest, and local HTTP result.

Request failures

Category	First inspection
Invalid request	Repository origin, selected source, and manifest shape.
Repository access	Forge App authorization and the repository named by the origin.
Runtime failure	Build output, startup command, port binding, and readiness route.
Route failure	The deployment result and the app exposure declaration.

Retry boundary

Do not retry a request until you know whether the failure came from source, configuration, build, runtime, or route handling. Keep the selected commit with the report.

Scope

This page contains no endpoint, token, or unsupported CLI instructions. The supported customer surface has one deployment operation and no separate error-inspection command.