CreateSkillDraft
Creates a skill in a specified workspace and generates an editable draft version. You can derive the draft from an existing version, or specify a target version and a commit message.
Operation description
Creates a skill and its draft in a workspace for editing skill instructions and related resources. You can derive the draft from an existing version, or specify a target version and a commit message.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
agentcore:CreateSkillDraft |
create |
*Skill
|
None | None |
Request syntax
POST /workspaces/{workspaceId}/skills HTTP/1.1
Path Parameters
|
Parameter |
Type |
Required |
Description |
Example |
| workspaceId |
string |
Yes |
The workspace ID. |
550e8400-e29b-41d4-a716-446655440000 |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| body |
object |
No |
The request body. |
|
| skillName |
string |
Yes |
The skill name. |
customer-service-skill |
| skillCard |
string |
No |
The JSON string of the skill card, which contains the complete skill information. |
{"name":"customer-service-skill","description":"..."} |
| basedOnVersion |
string |
No |
The version from which the draft is derived. If you leave this parameter empty, a new skill is created. |
0.0.1 |
| targetVersion |
string |
No |
The target version number of the draft. If you do not specify this parameter, the version number automatically increments. |
0.0.2 |
| commitMsg |
string |
No |
The commit message. |
Initial version |
When you call the operation to create a skill draft, specify the workspace ID and request body.
Response elements
|
Element |
Type |
Description |
Example |
|
object |
RestResult |
||
| requestId |
string |
The request ID. |
A1B2C3D4-E5F6-47A8-90AB-CDEF12345678 |
| data |
string |
The returned data. |
skill-1234567890abcdef |
The response to the operation for creating a skill draft includes the request ID and returned data.
Examples
Success response
JSON format
{
"requestId": "A1B2C3D4-E5F6-47A8-90AB-CDEF12345678",
"data": "skill-1234567890abcdef"
}
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 | NotFound | Not found: %s. | The specified workspace, resource, or version does not exist |
| 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.