Projects
Launch Projects provide a fully managed front-end hosting and deployment solution within Contentstack. It enables you to connect your Git repository, configure build settings, and automatically deploy web projects with seamless integration, scalability, and minimal downtime.
Get all Projects
GET
https://launch-api.contentstack.com/projectsThe Get all Projects request fetches the list of all projects in your organization.
Sample Response
Status|200 OK
{
"pagination": {
"count": 3,
"limit": 10,
"skip": 0
},
"projects": [
{
"uid": "68a327xxxxxxxx9d0d3",
"name": "Sample Project",
"organizationUid": "blt483xxxxxxx3589",
"repository": {
"repositoryName": "test/Calculator",
"username": "test",
"repositoryUrl": "https://github.com/test/Calculator"
},
"deletedAt": null,
"createdBy": "blt731xxxxxdc963",
"updatedBy": "blt731xxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-18T13:17:18.261Z",
"updatedAt": "2025-10-09T09:36:16.484Z",
"projectType": "GITPROVIDER"
},
{
"uid": "68b02f0xxxxxd6461d",
"name": "music",
"organizationUid": "blt483xxxxx83589",
"repository": {
"repositoryName": "test/music",
"username": "test",
"repositoryUrl": "https://github.com/test/music"
},
"deletedAt": null,
"createdBy": "blt731xxxxxdc963",
"updatedBy": "blt731xxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-28T10:27:15.850Z",
"updatedAt": "2025-08-28T10:27:31.065Z",
"projectType": "GITPROVIDER"
},
{
"uid": "689597axxxxxx47673",
"name": "nextjs-ssr-isr",
"organizationUid": "blt483xxxxx83589",
"repository": {
"repositoryName": "test/nextjs-ssr-isr",
"username": "test",
"repositoryUrl": "https://github.com/test/nextjs-ssr-isr"
},
"deletedAt": null,
"createdBy": "blt7315xxxxxxdc963",
"updatedBy": "blt7315xxxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-08T06:22:25.536Z",
"updatedAt": "2025-08-08T06:23:58.338Z",
"projectType": "GITPROVIDER"
}
]
}Create a Project
POST
https://launch-api.contentstack.com/projectsThe Create Project request creates a project in Launch using either a Git Provider or File Upload.
The examples below explain how to create projects using a Git Provider or the File Upload option.
Create a Project by FileUpload:
{
"name": "Sample file upload project",
"environment": {
"name": "Test Environment",
"outputDirectory": "./_site",
"frameworkPreset": "OTHER",
"description": "It is a test environment.",
"buildCommand": "npx @11ty/eleventy",
"environmentVariables": [],
"autoDeployOnPush": true
},
"projectType": "FILEUPLOAD",
"description": "Sample description",
"fileUpload": {
"uploadUid": "50xxxxa8"
}
}To create a project using FileUpload, you must run the following APIs step-by-step:
1. Get a Signed Upload URL for a Project.
2. Upload your ZIP file to Launch (The signed URL is valid only for 10 minutes).
Sample Request
{
"name": "Sample project",
"environment": {
"name": "Test Environment",
"outputDirectory": "./_site",
"frameworkPreset": "OTHER",
"description": "It is a test environment.",
"gitBranch": "main",
"buildCommand": "npx @11ty/eleventy",
"environmentVariables": [],
"autoDeployOnPush": true
},
"repository": {
"repositoryName": "TestUser20/eleventy-base-blog",
"username": "TestUser20",
"repositoryUrl": "https://github.com/TestUser20/eleventy-base-blog",
"gitProviderMetadata": {
"gitProvider": "GitHub"
}
},
"projectType": "GITPROVIDER",
"description": "Sample description"
}Sample Response
Status|200 OK
{
"project": {
"uid": "68a327xxxxxxxx9d0d3",
"name": "Sample Project",
"organizationUid": "blt483xxxxxxx3589",
"repository": {
"repositoryName": "TestUser20/eleventy-base-blog",
"username": "TestUser20",
"repositoryUrl": "https://github.com/TestUser20/eleventy-base-blog"
},
"deletedAt": null,
"createdBy": "blt731xxxxxdc963",
"updatedBy": "blt731xxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-18T13:17:18.261Z",
"updatedAt": "2025-10-09T09:36:16.484Z",
"projectType": "GITPROVIDER"
}
}Get a Project
GET
https://launch-api.contentstack.com/projects/{project_uid}The Get a Project request fetches a specific project in Launch using the project_uid path parameter.
Sample Response
Status|200 OK
{
"project": {
"uid": "68a327xxxxxxxx9d0d3",
"name": "Sample Project",
"organizationUid": "blt483xxxxxxx3589",
"repository": {
"repositoryName": "TestUser20/eleventy-base-blog",
"username": "TestUser20",
"repositoryUrl": "https://github.com/TestUser20/eleventy-base-blog"
},
"deletedAt": null,
"createdBy": "blt731xxxxxdc963",
"updatedBy": "blt731xxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-18T13:17:18.261Z",
"updatedAt": "2025-10-09T09:36:16.484Z",
"projectType": "GITPROVIDER"
}
}Update a Project
PUT
https://launch-api.contentstack.com/projects/{project_uid}The Update a Project request lets you update an existing project in your organization.
Sample Request
{
"name": "test",
"description": "This is a test project."
}Sample Response
Status|200 OK
{
"project": {
"uid": "68a327xxxxxxxx9d0d3",
"name": "test",
"organizationUid": "blt483xxxxxxx3589",
"repository": {
"repositoryName": "TestUser20/eleventy-base-blog",
"username": "TestUser20",
"repositoryUrl": "https://github.com/TestUser20/eleventy-base-blog"
},
"deletedAt": null,
"createdBy": "blt731xxxxxdc963",
"updatedBy": "blt731xxxxxdc963",
"deletedBy": null,
"createdAt": "2025-08-18T13:17:18.261Z",
"updatedAt": "2025-10-09T09:36:16.484Z",
"projectType": "GITPROVIDER",
"description": "This is a test project."
}
}Delete a Project
DELETE
https://launch-api.contentstack.com/projects/{project_uid}The Delete a Project request lets you delete an existing project in your organization.
Sample Response
Status|204 No Content
Project deleted successfully.
PATCH
https://launch-api.contentstack.com/projects/{project_uid}/git-repositoryundefined
Sample Request
{
"repositoryName": "new-owner/new-repo",
"username": "new-owner",
"repositoryUrl": "https://github.com/new-owner/new-repo"
}Sample Response
Status|200 OK
200 response