Skip to main content
POST
Create a builder from your own code

Authorizations

Authorization
string
header
required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Body

application/json
name
string
required

Builder name (lowercase letters, digits, dashes).

Example:

"my-api"

entrypoint
string
required

Command that starts your app. It must listen on 0.0.0.0 at port.

Example:

"python3 main.py"

files
object
required

Map of relative path → file contents. Include requirements.txt to pip-install before start.

Example:
port
integer

Port your app listens on. Default 8000.

Example:

8000

env
object

Non-secret environment variables.

Example:
resources
object

VM size. Defaults to 1 vCPU / 1 GB / 3 GB.

job_type
enum<string>
Available options:
always_on,
one_time
Example:

"always_on"

backup_interval_hours
integer

0 disables backups.

Example:

0

Response

Builder created and running.

success
boolean
Example:

true

message
string
Example:

"Builder created successfully"

data
object

A deployed builder (your code or an AI-generated app) running on a cloud sandbox.