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

Create temporary project

POST
/v1/projects/temp
Upload a file or set of files and instantly get a publicly accessible URL — no API key required.
The project is temporary: it expires in 15 minutes and has no owner. Use the claimToken from the response with POST /v1/projects/claim/{claimToken} to permanently assign it to your account before it disappears.
Limits (per request):
Up to 5 files
Total upload size ≤ 2 MB
Rate limits (per IP):
Burst: 3 uploads per minute
Hourly: 5 uploads per hour
ZIP handling: When uploading a .zip, the server auto-detects whether it contains HTML (→ static site) or not (→ file bundle). If the ZIP contains more than one HTML file you must include zipIndexHtmlPath to specify the home page, otherwise the request fails with ZIP_MULTIPLE_HTML and a list of available paths.

Request

Body Params multipart/form-dataRequired

Responses

🟢200
application/json
Upload successful. The project is live immediately at url and will auto-expire in 15 minutes unless claimed.
Body

🟠400
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://connect.litehost.io/v1/projects/temp' \
--form 'files=""' \
--form 'zipIndexHtmlPath=""' \
--form 'asFileBundle=""'
Response Response Example
200 - Success
{
    "status": "success",
    "data": {
        "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "slug": "blue-fox-42",
        "url": "https://blue-fox-42.litepage.site",
        "claimToken": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "expiresAt": "2026-04-03T01:30:00.000Z"
    }
}
Modified at 2026-04-03 07:05:50
Previous
Archive project
Next
Unarchive project
Built with