Create a durable app

POST/apps

Creates a named app the daemon keeps a healthy instance of, re-creating it from spec after a daemon restart. desired_state defaults to "running". The instance boots asynchronously; the response is the app's initial state.

Request bodyapplication/json

CreateAppRequest

desired_statestring

disk_bytesintegerint64

envobject

additional properties

string

healthHealthCheck

cmdarray

items

string

healthy_thresholdinteger

interval_sinteger

pathstring

portinteger

start_period_sinteger

timeout_sinteger

typestring

unhealthy_thresholdinteger

imageImageRef

ocistring

pathstring

memory_mibinteger

namestring

networkNetworkRequest

allowlistarray

items

string

allowlist_cidrarray

items

string

enabledboolean

full_egressboolean

portinteger

publisharray

items

PortMapping

guest_portinteger

host_ipstring

host_portinteger

protocolstring

publish_allboolean

pullstring

restartWireRestartPolicy

max_retriesinteger

policystring

serviceWireServiceSpec

cmdarray | null

items

string

cwdstring

envobject

additional properties

string

env_exactboolean

log_buffer_bytesinteger

restartWireRestartPolicy

max_retriesinteger

policystring

stop_grace_sinteger

stop_signalstring

userstring

vcpusinteger

Responses

201 CreatedCreated

AppResponse

created_atstringdate-time

desired_statestring

disk_bytesintegerint64

envobject

additional properties

string

generationintegermin 0

healthHealthCheck

cmdarray

items

string

healthy_thresholdinteger

interval_sinteger

pathstring

portinteger

start_period_sinteger

timeout_sinteger

typestring

unhealthy_thresholdinteger

idstring

imageImageRef

ocistring

pathstring

memory_mibinteger

namestring

networkNetworkRequest

allowlistarray

items

string

allowlist_cidrarray

items

string

enabledboolean

full_egressboolean

portinteger

publisharray

items

PortMapping

guest_portinteger

host_ipstring

host_portinteger

protocolstring

publish_allboolean

pullstring

restartWireRestartPolicy

max_retriesinteger

policystring

serviceWireServiceSpec

cmdarray | null

items

string

cwdstring

envobject

additional properties

string

env_exactboolean

log_buffer_bytesinteger

restartWireRestartPolicy

max_retriesinteger

policystring

stop_grace_sinteger

stop_signalstring

userstring

statusAppStatus

healthstring

instance_idstring

last_errorstring

phasestring

restartsinteger

updated_atstringdate-time

vcpusinteger

400 Bad requestBad Request

ErrorResponse

errorstring

403 ForbiddenForbidden

ErrorResponse

errorstring

409 ConflictConflict

ErrorResponse

errorstring

501 Not Implemented

ErrorResponse

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍POST/apps

cURL

curl '/apps' \
  -X POST \
  -H 'Content-Type: application/json' \
  -d '{}'

JavaScript

const response = await fetch("/apps", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
  },
  body: "{}",
});
const data = await response.json();

Python

import requests

response = requests.post(
    "/apps",
    headers={
    "Content-Type": "application/json",
},
    data="{}",
)
data = response.json()

Response

201 Created

{
  "created_at": "2026-01-02T15:04:05Z",
  "desired_state": "string",
  "disk_bytes": 0,
  "env": {},
  "generation": 0,
  "health": {
    "cmd": [
      "string"
    ],
    "healthy_threshold": 0,
    "interval_s": 0,
    "path": "string",
    "port": 0,
    "start_period_s": 0,
    "timeout_s": 0,
    "type": "string",
    "unhealthy_threshold": 0
  },
  "id": "string",
  "image": {
    "oci": "string",
    "path": "string"
  },
  "memory_mib": 0,
  "name": "string",
  "network": {
    "allowlist": [
      "string"
    ],
    "allowlist_cidr": [
      "string"
    ],
    "enabled": false,
    "full_egress": false
  },
  "port": 0,
  "publish": [
    {
      "guest_port": 0,
      "host_ip": "string",
      "host_port": 0,
      "protocol": "string"
    }
  ],
  "publish_all": false,
  "pull": "string",
  "restart": {
    "max_retries": 0,
    "policy": "string"
  },
  "service": {
    "cmd": [
      "string"
    ],
    "cwd": "string",
    "env": {},
    "env_exact": false,
    "log_buffer_bytes": 0,
    "restart": {
      "max_retries": 0,
      "policy": "string"
    },
    "stop_grace_s": 0,
    "stop_signal": "string",
    "user": "string"
  },
  "status": {
    "health": "string",
    "instance_id": "string",
    "last_error": "string",
    "phase": "string",
    "restarts": 0
  },
  "updated_at": "2026-01-02T15:04:05Z",
  "vcpus": 0
}