Welcome to LaunchVerseQuickstartDashboard OverviewImporting Projects
LaunchVerse ForgeScale-to-ZeroEnvironment Variable VersioningRollbacks & PromotionsPreview Environments
Helix CopilotEphemeral SandboxesAI Log Explainer
The LaunchVerse EdgeCustom Domains & TLSDomain PurchasingTwo-Factor Authentication (TOTP)IP Allowlists
Managed DatabasesDatabase Backups & RestoresLog DrainsObservability
Project GroupsRole-Based Access Control (RBAC)
Student ProgramDeveloper Streaks
AuthenticationProjectsDeploymentsDomainsDatabasesError Codes & Conventions
Changelog
Deployment GuideEnvironment Variables & SecretsTeam ManagementWeb ShellHow Builds Work (Forge)
JavaScript SDKPython SDK
API Reference (Redoc)

Deployments API

Build and deploy history, with preview state.

List Deployments

GET /api/v1/projects/:id/deployments

Returns deployment history for a project. Paginated and filterable by status.

Get a Deployment

GET /api/v1/projects/:id/deployments/:deployment_id

Returns a single deployment with full details including build logs and status.

Trigger a Deployment

POST /api/v1/projects/:id/deployments

Triggers a new deployment. Optionally specify a commit SHA or branch.

Deployment States

    1. queued — Waiting for a build slot
    2. building — Currently building
    3. deploying — Deploying to runtime
    4. live — Running and serving traffic
    5. failed — Build or deploy failed
    6. cancelled — Cancelled by user
Edit this page on GitHub↗