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

release

assess → publish → repin → deploy → verify, atomic and resumable; a failed phase leaves production on last-good.

ReleasePOST /capabilities/release
Releasethe Resource it produces
3 eventsReleaseStarted · ReleaseCompleted · ReleaseFailed

Ask your agent forge → release

you
Release hello to production.
claude
forge → release Done — Release created; I recorded ReleaseFailed.

From the terminal

$ forge release --app hello

HTTP :3717

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

{
  "app": "hello"
}

Input fields 29

app
platform
framework
host
publish_mode
dry_run
timeout_seconds
poll_interval_seconds
commit
image_ref
owner
registry
image_suffix
context
service
compose_file
env_file
allow_dirty
page_path
health_path
api_paths
cron_path
expect_google
expect_email
expect_password_signup
check_refresh
verify_timeout_ms
verify_readiness_timeout_ms
verify_readiness_interval_ms

Events ForgeEvent

ReleaseStarted   resource_type: Release
ReleaseCompleted   resource_type: Release
ReleaseFailed   resource_type: Release

Resource GET /resources/Release/:id

{
  "type": "Release",
  "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