plane: controlresource: Environmentrendered from forge v1.56.0 platform-model.json

provision-environment

Converge compose.yaml, forge.app.json (infra) and .env.example for the app's services.

ProvisionEnvironmentPOST /capabilities/provision-environment

Environmentthe Resource it produces

1 eventEnvironmentProvisioned

Ask your agent forge → provision-environment

you

Add a Postgres database to hello.

claude

forge → provision-environment Done — Environment created; I recorded EnvironmentProvisioned.

From the terminal

$ forge provision --app hello --with-postgres

HTTP :3717

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

{
  "app": "hello",
  "with_postgres": true
}

Input fields 13

app
platform
framework
with_postgres
with_redis
without_postgres
without_redis
postgres_port
redis_port
web_port
force
secrets
platform_store

Events ForgeEvent

EnvironmentProvisioned   resource_type: Environment

Resource GET /resources/Environment/:id

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