# Connect API Errors

Common HTTP error codes returned by the Connect API and their meaning.

Error responses have the same overall structure across the different Composable Commerce APIs. General errors, such as `ConcurrentModification` are returned across all APIs. API-specific errors, are only returned for a specific set of endpoints and update actions.

## Representations

#### ErrorResponse

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

#### ErrorObject

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

## General errors

#### 400 Bad Request

The following general error codes can appear in responses with the HTTP status code `400`:

##### InvalidJsonInput

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

##### InvalidQueryParam

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

##### InvalidPathParam

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

##### DuplicateField

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

##### FieldValueNotFound

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

##### GitRepositoryNotReachableError

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

#### 401 Unauthorized

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

#### 403 Forbidden

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

#### 404 Not Found

The following general error codes can appear in responses with the HTTP status code `404`:

##### ResourceNotFound

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

#### 409 Conflict

The following general error codes can appear in responses with the HTTP status code `409`:

##### ConcurrentModification

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

#### 500 Internal Server Error

The following general error codes can appear in responses with the HTTP status code `500`:

##### General

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

#### 502 Bad Gateway

The following general error codes can appear in responses with the HTTP status code `502`:

##### BadGateway

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

## API-specific errors

### Connectors

#### 400 Bad Request

##### DeploymentApplicationDoesNotExist

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

##### DeploymentLogInvalidDate

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

##### DeploymentLogInvalidPageToken

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

##### DeploymentLogMissingApplicationName

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

##### ConnectorAlreadyCertified

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

##### ConnectorReferenceNotFoundError

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

##### ConnectorSpecificationFileNotFoundError

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

##### ConnectorSpecificationFileNotValidError

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

##### ConnectorStagedInCertification

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

##### ConnectorStagedNotPreviewable

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

##### ConnectorStagedNotPrivate

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

##### ConnectorStagedPreviewRequestUnderProcess

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

### Deployments

#### 400 Bad Request

##### DeploymentUnsupportedRegion

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

##### DeploymentUnknownApplicationConfiguration

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

##### DeploymentUnknownApplicationConfigurationKey

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

##### DeploymentInvalidStatusTransition

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

##### DeploymentMissingGlobalConfigurationKey

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

##### DeploymentUnknownGlobalConfigurationKey

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

##### DeploymentEmptyRequiredGlobalConfigurationKey

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

#### 422 Unprocessable Content

##### DeploymentApplicationDoNotBelong

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

##### DeploymentApplicationRequired

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

##### DeploymentConnectorUpdateFailure

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

##### DeploymentProductionDeactivated

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

##### DeploymentInvalidType

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

## Related pages

- [Section overview page](https://docs.commercetools.com/connect.md)
- [Previous page: Common Types](https://docs.commercetools.com/connect/common-types.md)
- [Next page: Connector Staged](https://docs.commercetools.com/connect/connectors-staged.md)