DeleteWorkspace
Deletes a workspace that is no longer in use and ends the management lifecycle of the workspace.
Operation description
Deletes a workspace that is no longer in use and ends the management lifecycle of the workspace.
If you repeatedly delete the same workspace that is in the Deleting or Deleted state, the API operation processes the request based on idempotence.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
agentcore:DeleteWorkspace |
delete |
*Workspace
|
None | None |
Request syntax
DELETE /workspaces/{workspaceId} HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| workspaceId |
string |
Yes |
The ID of the workspace to be deleted. |
ws-123456 |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
No parameters required.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The response for deleting a workspace. |
||
| requestId |
string |
The request ID. |
request-123456 |
| message |
string |
The response message. |
success |
| httpStatusCode |
integer |
The HTTP status code. |
200 |
| code |
string |
The business status code. |
SUCCESS |
| success |
boolean |
Indicates whether the request is successful. |
true |
| data |
object |
The result of the deletion request. |
|
| workspaceId |
string |
The workspace ID. |
ws-123456 |
Examples
Success response
JSON format
{
"requestId": "request-123456",
"message": "success",
"httpStatusCode": 200,
"code": "SUCCESS",
"success": true,
"data": {
"workspaceId": "ws-123456"
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParameter | The specified request parameter is invalid. | |
| 404 | Resource.NotFound | The specified AgentCore workspace does not exist. | |
| 409 | Operation.Conflict | The workspace is not in a state that permits this operation. | |
| 409 | Resource.InUse | The workspace still contains agents, MCP servers, or model connections and cannot be deleted. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.