API referenceApplicationsGit deploys
Deploy an app from a git repository
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.
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"}