Deployments
Launch Deployments let you build, preview, and manage your project deployments seamlessly in real time. Whether you are importing code from a Git repository or uploading a ZIP file, each deployment provides detailed insights into build status, logs, and redeployment options—helping you track and manage every release with confidence.
Get all Deployments
https://launch-api.contentstack.com/projects/{project_uid}/environments/{environment_uid}/deploymentsThe Get all Deployments request fetches the list of all deployments within a specific environment of your project.
{
"pagination": {
"count": 1
},
"deployments": [
{
"uid": "690cxxxxxxxxxxxxx96a",
"environment": "691xxxxxxxxxxxxxxx1315",
"project": "691xxxxxxxxxxxxxxxx1316",
"gitBranch": "main",
"deploymentUrl": "sample-project.contentstackapps.com",
"repositoryUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog",
"commitHash": "4f0axxxxxxxxxxxxb75ea",
"commitMessage": "Merge pull request #151 from DougReeder/style-src-self\n\nRefactors style bundling so it's easy to avoid an insecure CSP",
"commitUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog/commit/4f0a64d7xxxxxxxxxxxxxxx2b75ea",
"buildCommand": "npx @11ty/eleventy",
"outputDirectory": "./_site",
"frameworkPreset": "OTHER",
"isCSRFramework": false,
"environmentVariables": [],
"status": "LIVE",
"isCancellable": false,
"latest": true,
"deploymentNumber": 1,
"createdAt": "2025-11-06T07:39:20.071Z",
"createdBy": "bltxxxxxxxx5783",
"previewUrl": "https://images.contentstack.io/v3/assets/bltxxxxxxxxx7b34/bltxxxxxxxx45f/690xxxxxxxxxxxx193/690xxxxxxxxxxc96a-preview.png",
"updatedAt": "2025-11-06T07:39:58.426Z",
"durationInSeconds": 25.032954443,
"nodeVersion": "22"
}
]
}Create a Deployment
https://launch-api.contentstack.com/projects/{project_uid}/environments/{environment_uid}/deploymentsThe Create Deployment request lets you create a new deployment in your Launch project.
The examples below explain how to create deployments using a Git Provider, Newly Uploaded File, or the Previously File Upload option.
Create a Deployment Using a Previously Uploaded File:
{}To create a deployment using a previously uploaded file, the system uses the most recent file uploaded to your project.
Create a Deployment Using a Newly Uploaded File:
{
"uploadUid": "133xxxxbe8"
}To create a deployment using FileUpload, you must run the following APIs step-by-step:
1. Get a Signed Upload URL for a Deployment.
2. Upload your ZIP file to Launch (The signed URL is valid only for 10 minutes).
{
"commitHash": "4f0xxxxxxxxxxxxxxxxxxxxxxxxxxxx75ea"
}{
"deployment": {
"uid": "690cxxxxxxxxxxxxx96a",
"environment": "691xxxxxxxxxxxxxxx1315",
"project": "691xxxxxxxxxxxxxxxx1316",
"gitBranch": "main",
"deploymentUrl": "sample-project.contentstackapps.com",
"repositoryUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog",
"commitHash": "4f0axxxxxxxxxxxxb75ea",
"commitMessage": "Merge pull request #151 from DougReeder/style-src-self\n\nRefactors style bundling so it's easy to avoid an insecure CSP",
"commitUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog/commit/4f0a64d7xxxxxxxxxxxxxxx2b75ea",
"buildCommand": "npx @11ty/eleventy",
"outputDirectory": "./_site",
"frameworkPreset": "OTHER",
"isCSRFramework": false,
"environmentVariables": [],
"status": "LIVE",
"isCancellable": false,
"latest": true,
"deploymentNumber": 1,
"createdAt": "2025-11-06T07:39:20.071Z",
"createdBy": "bltxxxxxxxx5783",
"previewUrl": "https://images.contentstack.io/v3/assets/bltxxxxxxxxx7b34/bltxxxxxxxx45f/690xxxxxxxxxxxx193/690xxxxxxxxxxc96a-preview.png",
"updatedAt": "2025-11-06T07:39:58.426Z",
"durationInSeconds": 25.032954443,
"nodeVersion": "22"
}
}Get a Deployment
https://launch-api.contentstack.com/projects/{project_uid}/environments/{environment_uid}/deployments/{deployment_uid}The Get a Deployment request retrieves a specific deployment from an environment of your project in Launch using the project_uid, environment_uid, and deployment_uid path parameters.
{
"deployment": {
"uid": "690cxxxxxxxxxxxxx96a",
"environment": "691xxxxxxxxxxxxxxx1315",
"project": "691xxxxxxxxxxxxxxxx1316",
"gitBranch": "main",
"deploymentUrl": "sample-project.contentstackapps.com",
"repositoryUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog",
"commitHash": "4f0axxxxxxxxxxxxb75ea",
"commitMessage": "Merge pull request #151 from DougReeder/style-src-self\n\nRefactors style bundling so it's easy to avoid an insecure CSP",
"commitUrl": "https://github.com/Vaxxxxxxxx20/eleventy-base-blog/commit/4f0a64d7xxxxxxxxxxxxxxx2b75ea",
"buildCommand": "npx @11ty/eleventy",
"outputDirectory": "./_site",
"frameworkPreset": "OTHER",
"isCSRFramework": false,
"environmentVariables": [],
"status": "LIVE",
"isCancellable": false,
"latest": true,
"deploymentNumber": 1,
"createdAt": "2025-11-06T07:39:20.071Z",
"createdBy": "bltxxxxxxxx5783",
"previewUrl": "https://images.contentstack.io/v3/assets/bltxxxxxxxxx7b34/bltxxxxxxxx45f/690xxxxxxxxxxxx193/690xxxxxxxxxxc96a-preview.png",
"updatedAt": "2025-11-06T07:39:58.426Z",
"durationInSeconds": 25.032954443,
"nodeVersion": "22"
}
}