Configuration
App settings can be changed without redeploying — the app keeps running while the platform
applies the new configuration. You can edit settings from the dashboard or via PUT /apps.
From the dashboard
Section titled “From the dashboard”Open the app in Apps, then edit its settings. The same fields you chose at deploy time are available: size, instances, ports, environment variables, volumes, labels, and the sleep-when-idle / run-once toggles. Changes apply live — no redeploy.
From the REST API
Section titled “From the REST API”PUT /apps fully replaces the app’s configuration, so include all fields. The body must include
the app’s id:
curl -X PUT https://api.cumin.dev/apps \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "id": "<app-id>", "project_id": "…", "name": "my-api", "image": "docker.io/nginx:latest", "ports": [{ "name": "web", "number": 80 }], "cpu": 400, "memory": 1024, "instances": 3, "hibernated": false }'Common changes
Section titled “Common changes”Resize (CPU & memory)
Section titled “Resize (CPU & memory)”Change the size by setting cpu (millicores) and memory (MB). See
Resource tiers for the size ladder:
curl -X PUT https://api.cumin.dev/apps \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "id": "<app-id>", "project_id": "…", "name": "my-api", "image": "docker.io/nginx:latest", "ports": [{ "name": "web", "number": 80 }], "cpu": 700, "memory": 2048, "instances": 1, "hibernated": false }'Scale (instances)
Section titled “Scale (instances)”Set instances to run more or fewer replicas (1–10).
Hibernate / wake
Section titled “Hibernate / wake”Set hibernated: true to sleep the app and release its resources; set it back to false to
wake it. See Apps.
Environment variables
Section titled “Environment variables”Add, update, or remove entries in the env array — see
Environment variables.
Next steps
Section titled “Next steps”- Environment variables
- Resource tiers
- Apps API reference — the full app object and update semantics