Start Node.js build
Start a Node.js build process using files already present on the website's file storage.
Start a Node.js build process using files already present on the website's file storage.
WARNING: on success this overwrites the website's existing contents and cannot be undone — verify this is intended before calling this endpoint.
The source_type must be archive and source_options.archive_path must point to an
existing archive file on the server (relative to the website document root).
Use the Generate Upload URL endpoint to obtain credentials and upload the archive first.
To auto-detect build settings from an archive before starting, first call the
Get Node.js Build Settings from Archive endpoint.
The returned build uuid can be used to poll progress and retrieve logs via
the Get Node.js Build Logs endpoint.
API Token authentication
u123456789Domain name
mydomain.tldNode.js version
20Possible values: Node.js application type
vitePossible values: Application root directory (where package.json is located) relative to public_html
webappBuild output directory relative to the root directory
distBuild script that will be ran to build the application
buildThe main entry point file for the application
server.jsPackage manager
npmPossible values: The source type of the files
archivePossible values: Success response
Build UUID
69f07fe2-197a-4fb3-9dae-606f965ad13dBuild state
pendingPossible values: Build options
Creation timestamp
2024-05-29T05:49:49.067239ZLast update timestamp
2024-05-29T05:49:49.067239ZUnauthenticated response
Validation error response
Error response
POST /api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds HTTP/1.1
Host: developers.hostinger.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 233
{
"node_version": 20,
"app_type": "vite",
"root_directory": "webapp",
"output_directory": "dist",
"build_script": "build",
"entry_file": "server.js",
"package_manager": "npm",
"source_type": "archive",
"source_options": {
"archive_path": "example.zip"
}
}{
"uuid": "69f07fe2-197a-4fb3-9dae-606f965ad13d",
"state": "pending",
"options": {
"node_version": 24,
"app_type": "vite",
"root_directory": "src",
"output_directory": "dist",
"build_script": "build",
"entry_file": "server.js",
"package_manager": "npm",
"source_type": "archive",
"source_options": {
"archive_path": "archive.zip"
}
},
"created_at": "2024-05-29T05:49:49.067239Z",
"updated_at": "2024-05-29T05:49:49.067239Z"
}Last updated
Was this helpful?