deploylisted

# Deploy Application ## Authentication Include an OAuth 2.0 access token in every request: ``` Authorization: Bearer ACCESS_TOKEN ``` Obtain tokens via the OAuth 2.0 flow at https://devtools.cloud/docs/oauth. ## Prerequisites - An OAuth 2.0 access token - A Git repository URL (GitHub, GitLab, or Bitbucket) ## Workflow Complete the following steps in order. ### Step 1: Create Application (if new) Skip this step if the app already exists. Use GET /apps to list existing apps. POST /apps ```json { "name": "my-app", "git_url": "https://github.com/user/repo", "branch": "main", "runtime": "nodejs" } ``` | Field | Type | Required | Description | |---------|--------|----------|--------------------------------------------| | name | string | yes | App name (lowercase, hyphens OK) | | git_url | string | yes | Git repository URL | | branch | string | no | Branch to deploy (default: main) | | runtime | string | no | `nodejs`, `python`, `go`, `rust` (auto-detected if omitted) | Response (201 Created): ```json { "id": "app_k8x7m", "name": "my-app", "status": "created", "git_url": "https://github.com/user/repo", "url": "https://my-app.devtools.cloud", "created_at": "2026-03-04T10:00:00Z" } ``` ### Step 2: Trigger Deployment POST /apps/{app_id}/deployments ```json { "branch": "main", "env_vars": { "NODE_ENV": "production", "DATABASE_URL": "p