apps

Tạo app từ git hoặc upload / Create an app from git or a local archive

source=git (mặc định) cần repo_url và trả job; source=upload trả id app, upload_url, max_bytes, job_id và chờ upload / Git returns a deployment job; upload returns an app ID and upload instructions while its create job waits. Repo public HTTPS hoặc source=upload → job Dokploy → URL HTTPS / Deploy public git or local archives via Dokploy. Poll /api/jobs/{id} tới succeeded/failed. App host dùng billing LXC Wave A; app không tính thêm phí. POST /api/app-hosts với {} dùng 2 CPU/2 GB RAM/30 GB disk; hỗ trợ billing_mode monthly + plan_code + period. X-Vibecloud-Sandbox: 1 trên /api/apps tạo URL giả, trả estimated_app_host và charged_vnd=0. PUT env thay toàn bộ env, cần POST deploy để áp dụng. Custom domain trả CNAME và SSL pending. Xoá app giữ host; xoá /api/services/{app_host_id} để ngừng phí.

post/api/apps

Request

  • Base URL: https://api.monacloud.vn
  • URL: https://api.monacloud.vn/api/apps
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Token

Headers

X-Vibecloud-Sandbox'1'

Tạo/list sandbox 0đ; lookup ID sandbox luôn giữ sandbox.

Request body

source'git' | 'upload'

Nguồn git hoặc thư mục local / Git repository or local archive.

namestring nullable

Tên app (slug hoá) làm tiền tố hostname; để trống thì lấy tên repo hoặc local-<mã> / Optional app name used as hostname prefix.

repo_urlstring nullable

Bắt buộc với source=git / Required for git sources.

branchstring
build_type'dockerfile' | 'nixpacks' | 'static'

Git mặc định dockerfile; upload tự nhận diện nếu bỏ qua / Git defaults to dockerfile; uploads auto-detect when omitted.

dockerfilestring
envobject
domainstring nullable
app_host_idstring nullable
portinteger

Example request

{
  "repo_url": "https://github.com/themonagroup/monacloud-example-node"
}

Response

Successful Response

OR

Changes

No recorded changes to this operation across all 1 revision of this API.