CreateAgentSpecVersion
Creates a new draft version for an existing AgentSpec. The AgentSpec must exist and cannot have a draft currently being edited.
Operation description
Creates a new draft version for an existing agent template (AgentSpec) to modify and publish the next version of the configuration.
The template must already exist and cannot have a draft currently being edited.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
agentcore:CreateAgentSpecVersion |
create |
*AgentSpec
|
None | None |
Request syntax
POST /workspaces/{workspaceId}/agent-specs/{agentSpecName}/versions 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 |
| body |
object |
No |
The request body. |
|
| basedOnVersion |
string |
No |
The existing version on which the draft is based. |
1.0.0 |
| targetVersion |
string |
No |
Specifies the draft version number. If you do not specify this parameter, the version number is automatically incremented. |
2.0.0 |
When you call the operation to create an AgentSpec draft version, specify the following parameters: workspace ID, unique name of the AgentSpec, and request body.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The version number of the newly created draft. |
||
| requestId |
string |
The request ID. |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
| data |
string |
The returned data. |
1.0.0 |
The response to the operation for creating an AgentSpec draft version includes the request ID and the returned data.
Examples
Success response
JSON format
{
"requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678",
"data": "1.0.0"
}
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.