AWS Cloud9
API Reference (API Version 2017-09-23)


Deletes an AWS Cloud9 development environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.

Request Syntax

{ "environmentId": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.


The ID of the environment to delete.

Type: String

Pattern: ^[a-zA-Z0-9]{8,32}$

Required: Yes

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.


For information about the errors that are common to all actions, see Common Errors.


The target request is invalid.

HTTP Status Code: 400


A conflict occurred.

HTTP Status Code: 400


An access permissions issue occurred.

HTTP Status Code: 400


An internal server error occurred.

HTTP Status Code: 500


A service limit was exceeded.

HTTP Status Code: 400


The target resource cannot be found.

HTTP Status Code: 400


Too many service requests were made over the given time period.

HTTP Status Code: 400


The following example deletes the specified AWS Cloud9 development environment.

Sample Request

POST / HTTP/1.1 Host: Accept-Encoding: identity Authorization: AWS4-HMAC-SHA256 Credential=AKIAJ32OEXAMPLE/20180123/us-east-2/cloud9/aws4_request, SignedHeaders=content-type;host;x-amz-date;x-amz-target, Signature=25619c96EXAMPLE X-Amz-Target: AWSCloud9WorkspaceManagementService.DeleteEnvironment User-Agent: aws-cli/1.14.29 Python/3.5.2 Windows/10 botocore/1.8.33 X-Amz-Date: 20180123T232227Z Content-Type: application/x-amz-json-1.1 Content-Length: 53 { "environmentId": "8d9967e2f0624182b74e7690ad69ebEX" }

Sample Response

HTTP/1.1 200 OK Date: Tue, 23 Jan 2018 23:22:29 GMT Content-Type: application/x-amz-json-1.1 Content-Length: 2 x-amzn-RequestId: 47682ed5-0094-11e8-9118-55255722b4EX Connection: Keep-alive {}

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: