Skip to main content
POST
Create an app

Authorizations

Authorization
string
header
required

Send your API token as Authorization: Bearer <api-token>.

Query Parameters

teamID
string

Run the request in the context of a team you belong to, instead of your personal account. 24-character hexadecimal ID.

Pattern: ^[0-9a-fA-F]{24}$

Body

application/json
name
string
required

Lowercase letters, digits and hyphens; can't start or end with a hyphen.

Required string length: 3 - 50
Pattern: ^[a-z0-9][a-z0-9\-]+[a-z0-9]$
planID
enum<string>
required

The app's resource plan. See Liara's pricing page for what each plan includes.

Available options:
small-g2,
medium-g2,
standard-base-g2,
standard-plus-g2,
pro-g2,
pro-plus-g2,
pro-max-g2
bundlePlanID
enum<string>
required

The app's bundle plan, which sets limits and features such as backups, log retention, deployments per day, domains, disks, zero-downtime deployment and rollback.

Available options:
basic,
standard,
pro
platform
enum<string>
required

The app's platform.

Available options:
node,
next,
react,
vue,
angular,
static,
laravel,
php,
django,
flask,
python,
netcore,
dotnet,
go,
docker
network
string
required

ID of one of your networks (see GET /v1/networks).

Pattern: ^[0-9a-fA-F]{24}$
readOnlyRootFilesystem
boolean

Make the app's filesystem read-only, except for its disks. Defaults to false for docker and next apps and true for the others.

isOneClickApp
boolean
default:false

Create the app for a one-click app. Its platform is set to docker.

Response

The app was created.

projectID
string

The new app's ID.