Skip to content

Managing apps

Once you’ve deployed, manage your apps and projects from the dashboard, or programmatically via the REST API.

From the dashboard, each service page (Apps, S3 Storage, PostgreSQL, …) lists its resources. From the API, GET the collection:

Terminal window
curl https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN"

List endpoints return only the resources your token can see.

Open the app in the dashboard, or fetch it from the API. GET /apps returns the full app object — status, URL, size, env vars, and more:

Terminal window
curl https://api.cumin.dev/apps \
-H "Authorization: Bearer $TOKEN" | jq '.[] | select(.name == "my-api")'

Change settings without redeploying — see Configuration. Updating is a PUT /apps with the app’s id and the full configuration.

Delete from the dashboard, or with the API:

Terminal window
# Delete an app
curl -X DELETE https://api.cumin.dev/apps/<app-id> \
-H "Authorization: Bearer $TOKEN"

Each resource type has its own delete endpoint — see the REST API overview.