# Deployments

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

Deployment contains a reference to a [Connector](https://docs.commercetools.com/connect/connectors.md#connectorreference), which is built and deployed in the specified [Region](https://docs.commercetools.com/connect/common-types.md#region).

As a [client](https://docs.commercetools.com/connect/overview.md#who-is-connect-for), you provide values for the [configuration](https://docs.commercetools.com/connect/deployments.md#configurationvalue) that the [creator](https://docs.commercetools.com/connect/overview.md#who-is-connect-for) defined in the Connector. These values act as environment variables for your 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

See API type definition [Deployment](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeployment).

#### DeploymentDraft

See API type definition [DeploymentDraft](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentDraft).

#### DeploymentPagedQueryResponse

See API type definition [DeploymentPagedQueryResponse](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentPagedQueryResponse).

#### DeploymentConnector

See API type definition [DeploymentConnector](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentConnector).

#### DeploymentCreator

See API type definition [DeploymentCreator](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentCreator).

#### DeploymentDetails

See API type definition [DeploymentDetails](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentDetails).

#### DeploymentDetailsBuild

See API type definition [DeploymentDetailsBuild](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentDetailsBuild).

#### DeploymentReport

See API type definition [DeploymentReport](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentReport).

#### DeploymentReportEntry

See API type definition [DeploymentReportEntry](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentReportEntry).

#### DeploymentReportEntryType

See API type definition [DeploymentReportEntryType](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentReportEntryType).

#### DeploymentConfigurationApplication

See API type definition [DeploymentConfigurationApplication](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentConfigurationApplication).

#### ApplicationDeployment

See API type definition [ApplicationDeployment](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3AApplicationDeployment).

#### ConfigurationValue

See API type definition [ConfigurationValue](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3AConfigurationValue).

#### DeploymentStatus

See API type definition [DeploymentStatus](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentStatus).

#### DeploymentGlobalConfiguration

See API type definition [DeploymentGlobalConfiguration](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentGlobalConfiguration).

#### DeploymentType

See API type definition [DeploymentType](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentType).

## Get Deployment

### Get Deployment by ID

See API endpoint definition [GET /\{projectKey}/deployments/\{id}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2F%7Bid%7D%3AGET).

### Get Deployment by Key

See API endpoint definition [GET /\{projectKey}/deployments/key=\{key}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2Fkey%3D%7Bkey%7D%3AGET).

## Query Deployments

See API endpoint definition [GET /\{projectKey}/deployments](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%3AGET).

## Create Deployment

See API endpoint definition [POST /\{projectKey}/deployments](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%3APOST).

## Update Deployment

### Update Deployment by ID

See API endpoint definition [POST /\{projectKey}/deployments/\{id}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2F%7Bid%7D%3APOST).

### Update Deployment by Key

See API endpoint definition [POST /\{projectKey}/deployments/key=\{key}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2Fkey%3D%7Bkey%7D%3APOST).

## Update actions

#### Redeploy

See API type definition [DeploymentRedeployAction](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Atype%3ADeploymentRedeployAction).

## Delete Deployment

### Delete Deployment by ID

See API endpoint definition [DELETE /\{projectKey}/deployments/\{id}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2F%7Bid%7D%3ADELETE).

### Delete Deployment by Key

See API endpoint definition [DELETE /\{projectKey}/deployments/key=\{key}](https://docs.commercetools.com/connect/deployments.md?urn=ctp%3Aconnect%3Aendpoint%3A%2F%7BprojectKey%7D%2Fdeployments%2Fkey%3D%7Bkey%7D%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/connect.md)
- [Previous page: Connectors](https://docs.commercetools.com/connect/connectors.md)
- [Next page: Deployment Logs](https://docs.commercetools.com/connect/deployment-logs.md)