1. Projects
Litehost Connect API
  • System
    • Health check
      GET
    • API info
      GET
  • Authentication
    • Request OTP code
      POST
    • Verify OTP and get API key
      POST
    • Check the current API key
      GET
  • User
    • Get current user
      GET
  • Projects
    • List projects
      GET
    • Create project
      POST
    • Create temporary project
      POST
    • Claim anonymous project
      POST
    • Get project
      GET
    • Push new version
      PUT
    • Update project settings
      PATCH
    • Delete project
      DELETE
    • Get deployment history
      GET
    • Archive project
      POST
    • Unarchive project
      POST
    • Link opens
      GET
  • 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. This is the fastest path for agents: no sign-in, no code.
The project is temporary: it expires in 15 minutes and has no owner. To keep it, give the user claimUrl: they open it and sign in with Google or email in the browser. If you already hold an API key you can instead call POST /v1/projects/claim/{claimToken}.
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.
Bodyapplication/json

🟠400
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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",
        "claimUrl": "https://litehost.io/claim/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "expiresAt": "2026-04-03T01:30:00.000Z"
    }
}
Modified at 2026-09-28 17:10:48
Previous
Create project
Next
Claim anonymous project
Built with