# Deployments

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

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

As a [client](/connect/overview.md#who-is-connect-for), you provide values for the [configuration](/connect/deployments.md#configurationvalue) that the [creator](/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

[type definition](/search.md?urn=ctp:connect:type:Deployment).

#### DeploymentDraft

[type definition](/search.md?urn=ctp:connect:type:DeploymentDraft).

#### DeploymentPagedQueryResponse

[type definition](/search.md?urn=ctp:connect:type:DeploymentPagedQueryResponse).

#### DeploymentConnector

[type definition](/search.md?urn=ctp:connect:type:DeploymentConnector).

#### DeploymentCreator

[type definition](/search.md?urn=ctp:connect:type:DeploymentCreator).

#### DeploymentDetails

[type definition](/search.md?urn=ctp:connect:type:DeploymentDetails).

#### DeploymentDetailsBuild

[type definition](/search.md?urn=ctp:connect:type:DeploymentDetailsBuild).

#### DeploymentReport

[type definition](/search.md?urn=ctp:connect:type:DeploymentReport).

#### DeploymentReportEntry

[type definition](/search.md?urn=ctp:connect:type:DeploymentReportEntry).

#### DeploymentReportEntryType

[type definition](/search.md?urn=ctp:connect:type:DeploymentReportEntryType).

#### DeploymentConfigurationApplication

[type definition](/search.md?urn=ctp:connect:type:DeploymentConfigurationApplication).

#### ApplicationDeployment

[type definition](/search.md?urn=ctp:connect:type:ApplicationDeployment).

#### ConfigurationValue

[type definition](/search.md?urn=ctp:connect:type:ConfigurationValue).

#### DeploymentStatus

[type definition](/search.md?urn=ctp:connect:type:DeploymentStatus).

#### DeploymentGlobalConfiguration

[type definition](/search.md?urn=ctp:connect:type:DeploymentGlobalConfiguration).

#### DeploymentType

[type definition](/search.md?urn=ctp:connect:type:DeploymentType).

## Get Deployment

### Get Deployment by ID

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/{id}:GET).

### Get Deployment by Key

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/key={key}:GET).

## Query Deployments

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments:GET).

## Create Deployment

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments:POST).

## Update Deployment

### Update Deployment by ID

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/{id}:POST).

### Update Deployment by Key

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/key={key}:POST).

## Update actions

#### Redeploy

[type definition](/search.md?urn=ctp:connect:type:DeploymentRedeployAction).

## Delete Deployment

### Delete Deployment by ID

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/{id}:DELETE).

### Delete Deployment by Key

[endpoint definition](/search.md?urn=ctp:connect:endpoint:/{projectKey}/deployments/key={key}:DELETE).

## Related pages

- [Area overview page with navigation](/connect.md)
- [Previous page: Connectors](/connect/connectors.md)
- [Next page: Deployment Logs](/connect/deployment-logs.md)
- [Search documentation and API specs](/search.md)