Redeploy Project

curl --request POST \
  --url https://api.example.com/api/redeploy/:projectId

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/redeploy/:projectId",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/redeploy/:projectId"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/redeploy/:projectId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "message": "<string>",
  "error": "<string>"
}

POST

api

redeploy

:projectId

Redeploy Project

curl --request POST \
  --url https://api.example.com/api/redeploy/:projectId

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/redeploy/:projectId",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/redeploy/:projectId"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/redeploy/:projectId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

{
  "message": "<string>",
  "error": "<string>"
}

Redeploys an existing project by triggering a new deployment with the current configuration. This endpoint:

Validates the project exists and is not deleted
Updates project status to building
Adds a redeployment job to the queue

Authentication

Requires JWT authentication via verifyJWT middleware.

Path Parameters

string

required

MongoDB ObjectId of the project to redeploy. Must be a valid ObjectId format.

Request Body

No request body required. All deployment configuration is read from the existing project record.

Validation

The endpoint validates:

projectId must be a valid MongoDB ObjectId format
Project must exist in the database
Project status must not be deleted

Response

string

Confirmation message indicating redeployment was initiated.

Success Response

{
  "message": "ReDeployment initiated"
}

Error Responses

string

Error message describing what went wrong.

string

Detailed error message for specific failures.

Common Errors

400 Bad Request: "Invalid projectId format" - ProjectId is not a valid MongoDB ObjectId
404 Not Found: "Invalid ProjectId" - Project not found or has been deleted
500 Internal Server Error: "Internal server Error" - Server processing error

Redeployment Queue

When redeployment is initiated:

Project status is updated to building
Project is saved to database
ProjectId is added to reDeploymentQueue
Redeployment worker processes the job asynchronously

The redeployment worker will:

Use existing project configuration (buildCommand, startCommand, env, etc.)
Fetch latest code from the configured branch
Create a new build record
Execute the build process
Update project status based on build result

Request Examples

Basic Redeploy

curl -X POST https://api.deployhub.com/api/redeploy/507f1f77bcf86cd799439011 \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

With Axios

import axios from 'axios';

const redeployProject = async (projectId) => {
  try {
    const response = await axios.post(
      `https://api.deployhub.com/api/redeploy/${projectId}`,
      {},
      {
        headers: {
          'Authorization': `Bearer ${token}`
        }
      }
    );
    console.log(response.data.message);
  } catch (error) {
    console.error('Redeployment failed:', error.response.data);
  }
};

redeployProject('507f1f77bcf86cd799439011');

With Fetch API

const redeployProject = async (projectId) => {
  const response = await fetch(
    `https://api.deployhub.com/api/redeploy/${projectId}`,
    {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${token}`,
        'Content-Type': 'application/json'
      }
    }
  );
  
  const data = await response.json();
  
  if (!response.ok) {
    throw new Error(data.error || data.message);
  }
  
  return data;
};

Response Example

Successful Redeployment

{
  "message": "ReDeployment initiated"
}

Invalid ProjectId Format

{
  "error": "Invalid projectId format"
}

Project Not Found

{
  "message": "Invalid ProjectId"
}

Use Cases

Manual Redeploy

Trigger a manual redeployment to:

Deploy latest code changes from the repository
Retry a failed deployment
Apply new environment variables (must be updated separately via settings endpoint)
Rebuild after infrastructure updates

CI/CD Integration

Integrate with CI/CD pipelines:

# GitHub Actions example
- name: Trigger Redeploy
  run: |
    curl -X POST https://api.deployhub.com/api/redeploy/${{ secrets.PROJECT_ID }} \
      -H "Authorization: Bearer ${{ secrets.DEPLOYHUB_TOKEN }}"

Webhook Automation

While DeployHub supports GitHub webhooks for automatic deployments, this endpoint can be used for:

Manual deployments outside of git pushes
Scheduled redeployments
Deployments triggered by external systems

Important Notes

Redeployment uses the existing project configuration
To change build settings, update via the project settings endpoint first
Project status changes to building immediately
Actual build is processed asynchronously by the redeployment worker
No new subdomain is generated - existing subdomain is retained
Build history is preserved - a new build record is created
Environment variables from the project configuration are used

Create Deployment - Create initial deployment
List Projects - Get all user projects
Update Project Settings - Modify project configuration before redeploying
Get Project Builds - View build history and status

Authentication

Deployments

Projects

User Management

Subscriptions

Redeploy Project

Authentication

Path Parameters

Request Body

Validation

Response

Success Response

Error Responses

Common Errors

Redeployment Queue

Request Examples

Basic Redeploy

With Axios

With Fetch API

Response Example

Successful Redeployment

Invalid ProjectId Format

Project Not Found

Use Cases

Manual Redeploy

CI/CD Integration

Webhook Automation

Important Notes

​Authentication

​Path Parameters

​Request Body

​Validation

​Response

​Success Response

​Error Responses

​Common Errors

​Redeployment Queue

​Request Examples

​Basic Redeploy

​With Axios

​With Fetch API

​Response Example

​Successful Redeployment

​Invalid ProjectId Format

​Project Not Found

​Use Cases

​Manual Redeploy

​CI/CD Integration

​Webhook Automation

​Important Notes

​Related Endpoints

Authentication

Path Parameters

Request Body

Validation

Response

Success Response

Error Responses

Common Errors

Redeployment Queue

Request Examples

Basic Redeploy

With Axios

With Fetch API

Response Example

Successful Redeployment

Invalid ProjectId Format

Project Not Found

Use Cases

Manual Redeploy

CI/CD Integration

Webhook Automation

Important Notes

Related Endpoints