DeleteAgentSpecVersion
Deletes the draft version of the specified AgentSpec that is currently being edited and clears the draft version pointer.
Operation description
Deletes the draft version of the agent template (AgentSpec) that is currently being edited.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
agentcore:DeleteAgentSpecVersion |
delete |
*AgentSpec
|
None | None |
Request syntax
DELETE /workspaces/{workspaceId}/agent-specs/{agentSpecName}/draft HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| workspaceId |
string |
Yes |
The workspace ID. |
550e8400-e29b-41d4-a716-446655440000 |
| agentSpecName |
string |
Yes |
The unique name of the AgentSpec. |
my-worker |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
No parameters required.
When you call the operation to delete an AgentSpec draft version, specify the following parameters: workspace ID and AgentSpec unique name.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
RestResult |
||
| requestId |
string |
The request ID. |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
| data |
boolean |
The returned data. |
The response to the operation to delete an AgentSpec draft version includes the following elements: request ID and returned data.
Examples
Success response
JSON format
{
"requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678",
"data": false
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | IllegalRequest | Illegal request: %s. | Illegal request |
| 400 | InvalidParameter | Parameter error: %s. | The parameter is invalid. |
| 400 | InvalidParameter.ImportFileSize | The import file size exceeds the allowed limit: %s. | The size of the imported file exceeds the limit. |
| 500 | InternalError | An internal error occurred. Please try again later. | Internal exception, please try again later; If it continues to fail, please provide RequestId troubleshootingAn internal service error occurred. Try again later. If the problem persists, provide the RequestId for troubleshooting. |
| 403 | NoPermission | You are not authorized to perform this operation: %s. | You do not have permission to perform this operation. |
| 404 | AgentSpecNotFound | Not found: %s. | |
| 409 | ResourceAlreadyExist | Resource already exists: %s. | The specified resource already exists |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.