The Apps API lets you deploy containers, manage environments, scale replicas, view logs, and perform rollbacks.

List Apps

Response:

Create an App

string
required
Application name (used for subdomain)
string
required
Source type: image, git, or upload
string
Docker image URL (required for image source type)
string
Git repository URL (required for git source type)
string
Git branch to deploy (default: main)
string
Build command for git/upload sources
integer
required
Port the application listens on
integer
Number of replicas (default: 1)
object
Environment variables as key-value pairs
string
Marketplace template ID for one-click deploys

Image-Based Deploy

Git-Based Deploy

Get an App

Update an App

Update configuration, scaling, or environment:

Delete an App

Removes the app and all associated Kubernetes resources (Deployment, Service, Ingress, ConfigMap).

Deploy / Redeploy

Trigger a new deployment:
For image-based apps, this pulls the latest version of the image. For git-based apps, this rebuilds from the latest commit.

Restart

Restart all pods without redeploying:

Build from Source

Upload source code as a tarball and trigger a build:

App Status

Get runtime status including ready replicas and pod phases:

Logs

Tail application logs from running pods:

Build Logs

View build output for git/upload deployments:

Metrics

Get CPU, memory, disk, and network metrics:

Deployment History

List all deployments:

Rollback

Revert to a previous deployment:

Pods

List running pods for the app:

Events

List Kubernetes events:

Audit Log

View all actions performed on the app: