Update build settings
Update the build directory, builder, and build or runtime commands for a service.
Request & response examples
curl --fail-with-body --request PATCH \ 'https://app.helicarrier.xyz/api/services/YOUR_ID/build' \ -H "Authorization: Bearer $HELI_API_KEY" \ -H 'Content-Type: application/json' \ --data '{ "rootDir": "apps/api", "buildCommand": "npm run build", "startCommand": "npm start"}'const response = await fetch( "https://app.helicarrier.xyz/api/services/YOUR_ID/build", { method: "PATCH", headers: { Authorization: `Bearer ${process.env.HELI_API_KEY}`, "Content-Type": "application/json" }, body: JSON.stringify({ "rootDir": "apps/api", "buildCommand": "npm run build", "startCommand": "npm start" }) });const data = await response.json();if (!response.ok) { throw new Error(`HTTP ${response.status}: ${data.error}`);}// Inspect data; avoid logging secret responses.import osimport requests
response = requests.request( "PATCH", "https://app.helicarrier.xyz/api/services/YOUR_ID/build", headers={ "Authorization": f"Bearer {os.environ['HELI_API_KEY']}" }, json={ "rootDir": "apps/api", "buildCommand": "npm run build", "startCommand": "npm start" }, timeout=30,)response.raise_for_status()data = response.json()# Inspect data; avoid logging secret responses.{ "id": "svc_example", "name": "my-app", "slug": "my-app", "sourceType": "image", "status": "running", "planKey": "heli-s1", "projectId": "prj_example", "environmentId": "env_example", "rootDir": "apps/api", "buildCommand": "npm run build", "startCommand": "npm start"}Illustrative values · selected fields
Path parameters
id string required Service id.
Request body
rootDir string optional Subdir the app lives in, e.g. apps/api. Empty for the repo root.
installCommand string optional Install override, e.g. npm ci.
buildCommand string optional Build override, e.g. npm run build.
startCommand string optional Start command; for a static site, the output directory.
dockerfilePath string optional Path to a Dockerfile relative to the root dir.
releaseCommand string optional Command run once before each release (migrations).
builder string optional "" auto | railpack | dockerfile | next.
Response 200
Returns the updated service. Saved build and runtime settings apply on the next deployment.
Examples show selected response fields with illustrative values. Your response can contain additional fields.
id string Unique identifier of this resource.
name string Human-readable resource name.
slug string URL-safe resource identifier.
sourceType string Source used to build or run the service.
status string Current state of the resource or operation.
planKey string Plan identifier from the plan catalog.
projectId string Project that owns the resource.
environmentId string Environment that contains the service.
rootDir string buildCommand string startCommand string Errors
400 Invalid parameters. Check the required fields, types, and resource configuration.
401 The API key is missing, invalid, or revoked.
403 The caller or key scope does not permit this operation.
500 The operation could not be completed. Check resource state before retrying a write.
update_build_settings
Required MCP arguments: id. Send path, query,
and body fields together as tool arguments.