LIliara-cloud
Apps

Create an app

Changed on

Creates an app in one of your networks. New apps get a few default environment variables for their platform. The app's name is also its default subdomain (<name>.liara.run) and must be unique across Liara.

Your balance must be high enough to cover your services, including the new app. Your account must be verified. With teamID, your role needs the project.create permission.

post/v1/projects

Request

  • Base URL
    https://api.liara.ir
  • URL
    https://api.liara.ir/v1/projects
  • Auth
    HTTP bearer

Query parameters

teamIDstring

24-character hexadecimal ID.

Run the request in the context of a team you belong to, instead of your personal account.

Request body

namestring required

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

planID'small-g2' | 'medium-g2' | 'standard-base-g2' | 'standard-plus-g2' | 'pro-g2' | 'pro-plus-g2' | 'pro-max-g2' required

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

bundlePlanID'basic' | 'standard' | 'pro' 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.

platform'node' | 'next' | 'react' | 'vue' | 'angular' | 'static' | 'laravel' | 'php' | 'django' | 'flask' | 'python' | 'netcore' | 'dotnet' | 'go' | 'docker' required

The app's platform.

networkstring required

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

readOnlyRootFilesystemboolean

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

isOneClickAppboolean

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

Response

The app was created.

projectIDstring

The new app's ID.

Changes

  • 610162e8a623Revision changes
    • breaking

      added the new required request property

    • breaking

      request property was restricted to a list of enum values

    • breaking

      request property was restricted to a list of enum values

    • breaking

      the request property became required

    • breaking

      the request property became required

    • breaking

      the request property became required

    • breaking

      the request property became required

    • breaking

      the request property's minLength was increased from 0 to 3

    • breaking

      added the pattern ^[0-9a-fA-F]{24}$ to the request property

    • breaking

      added the pattern ^[a-z0-9][a-z0-9\-]+[a-z0-9]$ to the request property

    • warning

      the request property's maxLength was set to 50

    • info

      added the new optional query request parameter teamID

    • info

      added the new optional request property

    • info

      added the new angular enum value to the request property

    • info

      added the new django enum value to the request property

    • info

      added the new docker enum value to the request property

    • info

      added the new dotnet enum value to the request property

    • info

      added the new flask enum value to the request property

    • info

      added the new go enum value to the request property

    • info

      added the new laravel enum value to the request property

    • info

      added the new medium-g2 enum value to the request property

    • info

      added the new netcore enum value to the request property

    • info

      added the new next enum value to the request property

    • info

      added the new node enum value to the request property

    • info

      added the new php enum value to the request property

    • info

      added the new pro-g2 enum value to the request property

    • info

      added the new pro-max-g2 enum value to the request property

    • info

      added the new pro-plus-g2 enum value to the request property

    • info

      added the new python enum value to the request property

    • info

      added the new react enum value to the request property

    • info

      added the new small-g2 enum value to the request property

    • info

      added the new standard-base-g2 enum value to the request property

    • info

      added the new standard-plus-g2 enum value to the request property

    • info

      added the new static enum value to the request property

    • info

      added the new vue enum value to the request property

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 1896585de5bbRevision changes
    • info

      added the new optional request property

    • info

      added the new optional request property