Deployments

Deployment represents the hosted application/integration which is managed by clients.

Deployment contains a reference to a Connector, which is built and deployed in the specified Region.

Clients can provide additional configuration values for specific Connectors which act as environment variables for their specific deployment.

Connectors that use third-party services may require that you have a commercial contract with the service provider before deploying the Connector.

Representations

Deployment

DeploymentDraft

DeploymentPagedQueryResponse

DeploymentConnector

DeploymentCreator

DeploymentDetails

DeploymentDetailsBuild

DeploymentReport

DeploymentReportEntry

DeploymentReportEntryType

DeploymentConfigurationApplication

ApplicationDeployment

ConfigurationValue

DeploymentStatus

DeploymentType

Deployment

`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.
`globalConfiguration` DeploymentGlobalConfiguration	Global configuration applied to all applications in the deployment.
`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 or ConnectorStaged being deployed.
`configurations` Array of DeploymentConfigurationApplication	Configuration values needed by the Connector for hosting. Keys should match those in the Connector's `configurations` field.
`globalConfiguration` DeploymentGlobalConfiguration	Global configuration values needed by the Connector for hosting. Keys should match those in the Connector's `globalConfiguration` 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"
}

DeploymentPagedQueryResponse

PagedQueryResult with results containing an array of Deployment.

`limit` Int	The limit of the Deployments returned.
`offset` Int	The offset of the Deployments returned.
`count` Int	The number of Deployments returned.
`total` Int	The total number of Deployments available.
`results` Array of Deployment	Deployments matching the query.

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.
`integrationTypes` Array of IntegrationType	Connector integration type list.
`creator` DeploymentCreator	Owner of the Connector.
`repository` Repository	Details of the GitHub repository that contains the Connect applications.
`configurations` Array of ConnectorConfigurationApplication	Configurations needed by Connectors for hosting. Loaded as environment variables in the application.
`globalConfiguration` ConnectorGlobalConfiguration	Global configuration applied to all applications in the deployment.
`certified` Boolean	If `true`, the Connector is certified.
`supportedRegions` Array of Region	If not empty, Connectors can only be deployed in these Regions. If empty, Connectors can be deployed in any supported Region.
`documentationUrl` String	URL to the documentation of the Connector.

Example: json

{
  "id": "a49aa2c5-15b6-41c4-88af-4b7afdcc07a5",
  "key": "connector-key",
  "version": 1,
  "name": "Connectors name",
  "description": "Connectors description",
  "integrationTypes": ["other"],
  "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.
`logoUrl` String	URL to an image used as the company logo.
`supportUrl` String	Url to support website of 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. MinLength: `2`MaxLength: `256`Pattern: `^[A-Za-z0-9_-]+$`
`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. After being set, these values are encrypted and cannot be accessed.
`url` String	URL generated after deployment of service applications.
`topic` String	Google Cloud 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.

DeploymentType

Deployment type of the Connector.

preview: The deployed Connector is the previewable ConnectorStaged.
production: The deployed Connector is the production Connector.

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",
    "integrationTypes": ["other"],
    "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",
    "integrationTypes": ["other"],
    "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.
`integrationTypes` IntegrationType	Filter the results by the `integrationType` of a Connector. The parameter can be passed multiple times.
`deploymentType` DeploymentType	Filter the results by the `deploymentType` of a Connector.

Response:

200DeploymentPagedQueryResponseasapplication/json

Request Example:cURL

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

200 Response Example: DeploymentPagedQueryResponsejson

{
  "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",
        "integrationTypes": ["other"],
        "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",
    "integrationTypes": ["other"],
    "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",
    "integrationTypes": ["other"],
    "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",
    "integrationTypes": ["other"],
    "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

Updates configuration values and redeploys a Deployment in Draft, Deployed, Failed, or UndeployFailed states. The new configuration values must include at least one valid application. Ensure that all deployment configuration keys and values match those specified in the application's connect.yaml file.

Specific error codes:

`action` String	`"redeploy"`
`skipScripts` Boolean	Whether the scripts execution should be skipped during redeployment. Default: `false`
`configurationValues` Array of DeploymentConfigurationApplication	New configuration values for Deployment. If empty, any existing value is unchanged.
`updateConnector` Boolean	Whether the Deployment Connector should be updated to its latest state during redeployment. Default: `false`

Example: json

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

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",
    "integrationTypes": ["other"],
    "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",
    "integrationTypes": ["other"],
    "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"
}