1. Projects
Litehost Connect API
  • System
    • Health check
      GET
    • API info
      GET
  • Authentication
    • Request OTP code
      POST
    • Verify OTP and get API key
      POST
  • User
    • Get current user
      GET
  • Projects
    • List projects
      GET
    • Create project
      POST
    • Get project
      GET
    • Push new version
      PUT
    • Update project settings
      PATCH
    • Delete project
      DELETE
    • Get deployment history
      GET
    • Archive project
      POST
    • Create temporary project
      POST
    • Unarchive project
      POST
    • Claim anonymous project
      POST
  • Domains
    • List domains
      GET
    • Get domain
      GET
  • Workspaces
    • List workspaces
      GET
    • Create workspace
      POST
    • Rename workspace
      PATCH
    • Delete workspace
      DELETE
  • Schemas
    • Project
    • Deployment
    • Domain
    • DomainDetail
    • WorkspaceSummary
    • ErrorResponse
    • SuccessResponse
    • FreeTierRestricted
  1. Projects

Push new version

PUT
/v1/projects/{projectId}
Paid plan required. Not available on the free tier — upgrade to starter or higher.
Upload new content to an existing project. Replaces the live files and increments the deployment version. Previous versions are kept in history.
When uploading a .zip, the system automatically determines how to handle it:
No HTML files → treated as a file bundle
One HTML file → treated as a static site (used as homepage)
Multiple HTML files → you must provide zipIndexHtmlPath to specify the homepage
If zipIndexHtmlPath is missing or invalid when multiple HTML files are found, the request will fail and return the list of detected HTML files.
Set asFileBundle: true to skip detection entirely and always treat the upload as a file bundle.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Body Params multipart/form-dataRequired

Responses

🟢200
application/json
Deployment successful
Bodyapplication/json

🟠401
🟠403
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://connect.litehost.io/v1/projects/' \
--header 'Authorization: Bearer <token>' \
--form 'files=""' \
--form 'zipIndexHtmlPath=""' \
--form 'asFileBundle=""'
Response Response Example
200 - Example 1
{
    "status": "success",
    "data": {
        "deploymentId": "dep_v2",
        "url": "http://example.com"
    }
}
Modified at 2026-04-03 07:05:46
Previous
Get project
Next
Update project settings
Built with