Interlaken
API referenceApplicationsGit deploys

Deploy an app from a git repository

POST
/api/v1/git-deploys

Requires the vms:create permission.

Boots a microVM (default) or VM whose generated cloud-init clones repo_url@branch into /app, runs build_command, and runs start_command as a systemd service (EnvironmentFile /etc/interlaken/env from env_vars). Private repos clone with a token from the github connector (connector_id, or the tenant default). Returns the created VM — watch the build in the machine's Console tab.

Authorization

AuthorizationBearer <token>

An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/git-deploys" \  -H "Content-Type: application/json" \  -d '{    "repo_url": "string",    "start_command": "string"  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "kind": "string",  "name": "string"}