Delete an Annotation Set API
Note: Register now for Alexa Live, Amazon’s annual Alexa developer conference on July 20, 2022.
The Delete an Annotation Set API deletes the annotation set identified by Annotation set Id.
HTTP method and path
DELETE v1/skills/{skillId}/asrAnnotationSets/{annotationSetId}
Attributes | Type | Description | Required |
---|---|---|---|
skillId | String | Skill Id as part of the URI path. | Yes |
annotationSetId | String | Annotation set Id as part of the request URI path. | Yes |
Request
Request headers
Content-Type: application/json
Accept: application/json
Request body
None.
Response
HTTP status
HTTP 204 No Content
Response headers
Content-Type: application/json
Response body
None.
Error response
This section lists call-specific errors. For a reference of errors that can apply to all Automatic Speech Recognition (ASR) APIs, see Automatic Speech Recognition API Error Reference.
HTTP Status Code | Error Code | Scenario |
---|---|---|
400 Bad Request | INVALID_REQUEST_PARAMETER | Annotation set Id is malformed. |
Skill Id is malformed. | ||
409 Conflict | RESOURCE_IN_USE | The annotation set is currently in use in an evaluation run. |
404 Not Found |
RESOURCE_NOT_FOUND |
Requested skill does not exist. |
Requested annotation set does not exist. |
||
500 Internal Server Error |
INTERNAL_SERVER_ERROR |
Request failed due to an internal server error. |
Examples
Sample Request | Sample Response |
---|---|
DELETE /v1/skills/1234/asrAnnotationSets/123-1234-1234 HTTP/1.1
Accept: application/json
|
HTTP 204 NO CONTENT
|
DELETE /v1/skills/1234/asrAnnotationSets/123-1234-1234 HTTP/1.1
Accept: application/json
|
HTTP 404 Not Found
Content-Type: application/json
{
"message": "Annotation set with id \"123-1234-1234\" cannot be found",
"code": "RESOURCE_NOT_FOUND"
}
|
Related topics
- What is Automatic Speech Recognition?
- Create an Annotation Set for Automatic Speech Recognition (ASR)
- Run an Automatic Speech Recognition (ASR) Evaluation
- Improve your Automatic Speech Recognition (ASR) Test Results
- Create annotation set API
- Update annotation set annotations API
- Post ASR evaluation API
- Get ASR evaluation results API
- Create catalog API
- Batch Test Your Natural Language Understanding (NLU) Model