POST

/applications/{ApplicationId}/environments/{EnvironmentId}/deployments

http://appconfig.{region}.amazonaws.com/applications/{ApplicationId}/environments/{EnvironmentId}/deployments

Starts a deployment.

Access Token Required: API Key

Path Parameters

ApplicationIdstringrequired

The application ID.

EnvironmentIdstringrequired

The environment ID.

Body Params

Tagsobject

Metadata to assign to the deployment. Tags help organize and categorize your AppConfig resources. Each tag consists of a key and an optional value, both of which you define.

Descriptionstring

A description of the deployment.

KmsKeyIdentifierstring

The KMS key identifier (key ID, key alias, or key ARN). AppConfig uses this ID to encrypt the configuration data using a customer managed key.

ConfigurationVersionstringrequired

The configuration version to deploy. If deploying an AppConfig hosted configuration version, you can specify either the version number or version label.

DeploymentStrategyIdstringrequired

The deployment strategy ID.

ConfigurationProfileIdstringrequired

The configuration profile ID.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://appconfig.{region}.amazonaws.com/applications/{ApplicationId}/environments/{EnvironmentId}/deployments' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}