forge
Clone forge-starter
plane: controlresource: DeploymentC7needs Dockerrendered from forge v1.56.0 platform-model.json

deploy

Start-first zero-downtime roll of compose.prod.yaml behind the proxy, with a drift gate. Usually driven by release.

DeployPOST /capabilities/deploy
Deploymentthe Resource it produces
3 eventsDeploymentStarted · DeploymentCompleted · DeploymentRolledBack

Ask your agent forge → deploy

you
Deploy hello.
claude
forge → deploy Done — Deployment created; I recorded DeploymentRolledBack.

From the terminal

$ forge deploy --app hello

HTTP :3717

POST /capabilities/deploy
Content-Type: application/json
x-forge-actor-type: builder
x-forge-actor-id: cli

{
  "app": "hello",
  "service": "web"
}

Input fields 11

app
platform
framework
service
context
compose_file
env_file
proxy_net
pull
drain_seconds
timeout_seconds

Events ForgeEvent

DeploymentStarted   resource_type: Deployment
DeploymentCompleted   resource_type: Deployment
DeploymentRolledBack   resource_type: Deployment

Resource GET /resources/Deployment/:id

{
  "type": "Deployment",
  "id": "res_01J…",
  "app_id": "app_hello",
  "status": "succeeded",
  "created_at": "2026-09-03T14:00:00Z"
}

Errors: see Reference → Errors. Find it in the playground