SubmitAgentSpecVersion
Submits a specified draft version of an AgentSpec for review. If no release pipeline is configured, the version is directly published online.
Operation description
Submits a specified draft version of an agent template for review. If no release pipeline is configured, the version is directly published online.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
agentcore:SubmitAgentSpecVersion |
update |
*AgentSpec
|
None | None |
Request syntax
POST /workspaces/{workspaceId}/agent-specs/{agentSpecName}/versions/{agentSpecVersion}/actions/submit 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 |
| agentSpecVersion |
string |
Yes |
The version number of the AgentSpec. |
0.0.1 |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
When calling the operation to submit an AgentSpec version for review, pass the following parameters as defined: workspace ID, AgentSpec unique name, AgentSpec version number, and request body.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
The actual submitted version number. |
||
| requestId |
string |
The request ID. |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
| data |
string |
The returned data. |
1.0.0 |
The response to the operation for submitting an AgentSpec version for review includes the request ID and 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.