Deployments

`id` String	Unique identifier of the Deployment.
`version` Int	Current version of the Deployment.
`key` String	User-defined unique identifier of the Deployment. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`
`connector` DeploymentConnector	Details of the Connector being deployed.
`details` DeploymentDetails	Build reference id and outcome of the Deployment.
`deployedRegion` Region	Region of the Deployment.
`applications` Array of ApplicationDeployment	Application deployments needed by the connector for hosting and configuration, refer to Connector configurations for details.
`preview` Boolean	If `true`, the Deployment is a preview.
`status` DeploymentStatus	The current status of the Deployment.

DeploymentDraft

`key` String	User-defined unique identifier for the Deployment. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`
`connector` ConnectorReference	Reference to the Connector being deployed.
`configurations` Array of DeploymentConfigurationApplication	Configuration values needed by the Connector for hosting. Keys should match those in the Connector's `configurations` field.
`region` Region	Region of Deployment.

Example: json

{
  "key": "key-for-my-deployment",
  "connector": {
    "key": "connector-key",
    "version": 1
  },
  "configurations": [
    {
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ]
    }
  ],
  "region": "europe-west1.gcp"
}

DeploymentConnector

The details of the deployed Connector.

`id` String	`id` of the Connector.
`version` Int	Version of the Connector.
`key` String	User-defined unique identifier of the Connector.
`name` String	Name of the Connector.
`description` String	Description of the Connector.
`creator` DeploymentCreator	Owner of the Connector.
`repository` Repository	Details of the GitHub repository that contains the Connect applications.
`certified` Boolean	If `true`, the Connector is certified.

Example: json

{
  "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
  "key": "connector-key",
  "version": 1,
  "name": "Connectors name",
  "description": "Connectors description",
  "creator": {
    "title": "Mr",
    "name": "John Doe",
    "email": "john.doe@example.com",
    "company": "commercetools",
    "noOfContributors": 200
  },
  "repository": {
    "url": "git@github.com:commercetools/connect-application-kit.git",
    "tag": "0.0.0"
  },
  "certified": true
}

DeploymentCreator

The details of the deployed DeploymentConnector creator.

`name` String	Name of the person who owns the Connector.
`title` String	Title of the person who owns the Connector.
`email` String	Contact email address of the creator.
`company` String	Name of the company that owns the Connector.
`noOfContributors` Int	Number of contributors currently working for the company.

Example: json

{
  "title": "Mr",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "company": "commercetools",
  "noOfContributors": 200
}

DeploymentDetails

Additional details about the deployed Connector.

build

DeploymentDetailsBuild

The build details of deployed applications.

DeploymentDetailsBuild

`id` String	The build execution id of the deployed application.
`report` DeploymentReport	The build report of the deployed Connector.

Example: json

{
  "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
  "report": {
    "entries": [
      {
        "type": "Warning",
        "application": "service",
        "title": "Failed during the execution of 'postDeploy' script",
        "createdAt": "2023-08-08T17:00:59.327Z"
      }
    ]
  }
}

DeploymentReport

Describes a report of the Connector deployment process.

entries

Array of DeploymentReportEntry

Contains informations, errors and warnings about the Connector deployment.

DeploymentReportEntry

Describes an information, error, or warning in the deployment report.

`type` DeploymentReportEntryType	The report entry type.
`title` String	The title of the report entry.
`message` String	The message related to the report entry.
`application` String	The name of the Connect application related to the entry.
`createdAt` DateTime	When the report entry was created.

DeploymentReportEntryType

The type of message being reported.

Information: Indicates information returned during the deployment process.
Warning: Indicates an issue that arose during the deployment process.
Error: Indicates a crash or failure to complete the deployment process.

DeploymentConfigurationApplication

Describes the configuration set of a given application.

`applicationName` String	Name of the application. Should match the value of `name` within the connect.yaml file of the Connect application.
`standardConfiguration` Array of ConfigurationValue	Contains values of keys that are saved in plain text. Can be accessed after being set.
`securedConfiguration` Array of ConfigurationValue	Contains values of secret keys. Cannot be accessed after being set.

ApplicationDeployment

Describes an application deployment of the Connector.

`id` String	Unique identifier of the application deployment.
`applicationName` String	Name of the application. Should match the value of `name` within the connect.yaml file of the Connector.
`standardConfiguration` Array of ConfigurationValue	Contains values of keys that are saved in plain text. Can be accessed after being set.
`securedConfiguration` Array of ConfigurationValue	Contains values of secret keys. Cannot be accessed after being set.
`url` String	URL generated after deployment of service applications.
`topic` String	Pub/Sub Topic generated after deployment of event applications.
`schedule` String	Cron schedule for job applications.

Example: json

{
  "id": "e478afb6-dd35-4f3d-a460-6f5f97988ebb",
  "applicationName": "app-3",
  "standardConfiguration": [
    {
      "key": "CONFIG_KEY",
      "value": "config key value"
    }
  ],
  "securedConfiguration": [
    {
      "key": "CONFIG_SECRET",
      "value": "config secret value"
    }
  ],
  "schedule": "* * * * 5"
}

ConfigurationValue

`key` String	Name of the environment variable.
`value` String	Value of the environment variable.

Example: json

{
  "key": "CONFIG_KEY",
  "value": "config key value"
}

DeploymentStatus

Indicates the current status of the Deployment.

Draft
Queued: The Deployment is in a queue waiting to be processed.
Deploying: The deployment process has started.
Deployed: The Deployment is live.
Failed: The deployment process failed.
Undeploying: The Deployment is being undeployed.
UndeployFailed: The process to undeploy failed.

Get Deployment

Get Deployment by ID

GET

https://connect.{region}.commercetools.com/{projectKey}/deployments/{id}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey} , view_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`id` String	`id` of the Deployment

Response:

200Deploymentasapplication/json

Request Example:cURL

curl --get https://connect.{region}.commercetools.com/{projectKey}/deployments/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

200 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Get Deployment by Key

GET

https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey} , view_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`key` String	`key` of the Deployment

Response:

200Deploymentasapplication/json

Request Example:cURL

curl --get https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

200 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Query Deployments

GET

https://connect.{region}.commercetools.com/{projectKey}/deployments

Retrieves all deployments of a project key.

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey} , view_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.

Query parameters:

`limit` Int	Number of results requested.
`offset` Int	Number of elements skipped.
`sort` String	The parameter can be passed multiple times.

Response:

200

Paged

asapplication/json

Request Example:cURL

curl --get https://connect.{region}.commercetools.com/{projectKey}/deployments -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

200 Response Example: Pagedjson

{
  "offset": 0,
  "limit": 20,
  "total": 1,
  "count": 1,
  "results": [
    {
      "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
      "key": "deployment-key",
      "version": 1,
      "connector": {
        "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
        "key": "connector-key",
        "version": 1,
        "name": "Connectors name",
        "description": "Connectors description",
        "creator": {
          "title": "Mr",
          "name": "John Doe",
          "email": "john.doe@example.com",
          "company": "commercetools",
          "noOfContributors": 200
        },
        "repository": {
          "url": "git@github.com:commercetools/connect-application-kit.git",
          "tag": "0.0.0"
        },
        "certified": true
      },
      "details": {
        "build": {
          "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
          "report": {
            "entries": [
              {
                "type": "Warning",
                "application": "service",
                "title": "Failed during the execution of 'postDeploy' script",
                "createdAt": "2023-08-08T17:00:59.327Z"
              }
            ]
          }
        }
      },
      "applications": [
        {
          "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
          "applicationName": "app-3",
          "standardConfiguration": [
            {
              "key": "CONFIG_KEY",
              "value": "config-key-value"
            }
          ],
          "securedConfiguration": [
            {
              "key": "CONFIG_SECRET_KEY",
              "value": "config-secret-key-value"
            }
          ],
          "schedule": "* * * * 5"
        }
      ],
      "deployedRegion": "europe-west1.gcp",
      "preview": true,
      "status": "Deployed"
    }
  ]
}

Create Deployment

POST

https://connect.{region}.commercetools.com/{projectKey}/deployments

Specific Error Codes:

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.

Request Body:DeploymentDraftasapplication/json

Response:

201Deploymentasapplication/json

Request Example:cURL

curl https://connect.{region}.commercetools.com/{projectKey}/deployments -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "key" : "deployment-key",
  "connector" : {
    "id" : "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "version" : 1
  },
  "region" : "europe-west1.gcp",
  "configurations" : [ {
    "applicationName" : "app-1",
    "standardConfiguration" : [ {
      "key" : "CONFIG_KEY",
      "value" : "config-key-value"
    } ],
    "securedConfiguration" : [ {
      "key" : "CONFIG_SECRET_KEY",
      "value" : "config-secret-key-value"
    } ]
  } ]
}
DATA

201 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Update Deployment

Update Deployment by ID

POST

https://connect.{region}.commercetools.com/{projectKey}/deployments/{id}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`id` String	`id` of the Deployment

Request Body:

application/json

`version` Int	Expected version of the Deployment on which the changes apply.
`actions` Array of DeploymentUpdateAction	Update actions to be performed on the Deployment.

Response:

201Deploymentasapplication/json

Request Example:cURL

curl https://connect.{region}.commercetools.com/{projectKey}/deployments/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "redeploy",
    "configurationValues" : [ {
      "applicationName" : "app-1",
      "standardConfiguration" : [ {
        "key" : "CONFIG_KEY",
        "value" : "config-key-value"
      } ],
      "securedConfiguration" : [ {
        "key" : "CONFIG_SECRET_KEY",
        "value" : "config-secret-key-value"
      } ]
    } ]
  } ]
}
DATA

201 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Update Deployment by Key

POST

https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`key` String	`key` of the Deployment

Request Body:

application/json

`version` Int	Expected version of the Deployment on which the changes apply.
`actions` Array of DeploymentUpdateAction	Update actions to be performed on the Deployment.

Response:

201Deploymentasapplication/json

Request Example:cURL

curl https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}' \
--header 'Content-Type: application/json' \
--data-binary @- << DATA 
{
  "version" : 1,
  "actions" : [ {
    "action" : "redeploy",
    "configurationValues" : [ {
      "applicationName" : "app-1",
      "standardConfiguration" : [ {
        "key" : "CONFIG_KEY",
        "value" : "config-key-value"
      } ],
      "securedConfiguration" : [ {
        "key" : "CONFIG_SECRET_KEY",
        "value" : "config-secret-key-value"
      } ]
    } ]
  } ]
}
DATA

201 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Update actions

Redeploy

Update the configuration values and redeploy the Deployment.

Attempting to redeploy a Deployment that does not require configuration or a configuration key for an application returns the DeploymentUnknownApplicationConfiguration or DeploymentUnknownApplicationConfigurationKey errors, respectively.

Attempting to redeploy a Deployment with a Queued, Deploying, or Undeploying DeploymentStatus returns a DeploymentInvalidStatusTransition error.

`action` String	`"redeploy"`
`skipScripts` Boolean	If scripts execution should be skipped during deployment. Default: `false`
`configurationValues` Array of DeploymentConfigurationApplication	New configuration values for Deployment. If empty, any existing value is unchanged.

Example: json

{
  "action": "redeploy",
  "configurationValues": [
    {
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ]
    }
  ]
}

Delete Deployment

Delete Deployment by ID

DELETE

https://connect.{region}.commercetools.com/{projectKey}/deployments/{id}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`id` String	`id` of the Deployment

Response:

200Deploymentasapplication/json202Deploymentasapplication/json

Request Example:cURL

curl -X DELETE https://connect.{region}.commercetools.com/{projectKey}/deployments/{id} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

202 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}

Delete Deployment by Key

DELETE

https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key}

OAuth 2.0 Scopes:

manage_project:{projectKey} , manage_connectors_deployments:{projectKey}

Path parameters:

`region` String	Region in which the Project is hosted.
`projectKey` String	The Composable Commerce Project key.
`key` String	`key` of the Deployment

Response:

200Deploymentasapplication/json202Deploymentasapplication/json

Request Example:cURL

curl -X DELETE https://connect.{region}.commercetools.com/{projectKey}/deployments/key={key} -i \
--header 'Authorization: Bearer ${BEARER_TOKEN}'

202 Response Example: Deploymentjson

{
  "id": "13c72c44-7a8e-44f2-a570-b5e991f7021a",
  "key": "deployment-key",
  "version": 1,
  "connector": {
    "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
    "key": "connector-key",
    "version": 1,
    "name": "Connectors name",
    "description": "Connectors description",
    "creator": {
      "title": "Mr",
      "name": "John Doe",
      "email": "john.doe@example.com",
      "company": "commercetools",
      "noOfContributors": 200
    },
    "repository": {
      "url": "git@github.com:commercetools/connect-application-kit.git",
      "tag": "0.0.0"
    },
    "certified": true
  },
  "details": {
    "build": {
      "id": "a317ce94-5149-45ec-8717-d1c05b49005a",
      "report": {
        "entries": [
          {
            "type": "Warning",
            "application": "service",
            "title": "Failed during the execution of 'postDeploy' script",
            "createdAt": "2023-08-08T17:00:59.327Z"
          }
        ]
      }
    }
  },
  "applications": [
    {
      "id": "c9c3b342-c2ca-11ed-afa1-0242ac120002",
      "applicationName": "app-1",
      "standardConfiguration": [
        {
          "key": "CONFIG_KEY",
          "value": "config-key-value"
        }
      ],
      "securedConfiguration": [
        {
          "key": "CONFIG_SECRET_KEY",
          "value": "config-secret-key-value"
        }
      ],
      "url": "app1.commercetools.app"
    }
  ],
  "deployedRegion": "europe-west1.gcp",
  "preview": true,
  "status": "Deployed"
}