Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Deletes specific examples by ID from DRAFT. All example IDs are validated before any deletes occur. If any ID does not exist in DRAFT, the entire batch is rejected (all-or-nothing semantics).

post/datasets/{datasetId}/examples/delete

Path parameters

datasetIdstring required

The unique identifier of the dataset.

Request body

clientTokenstring

A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.

exampleIdsExampleId[] required

The IDs of the examples to delete.

Response

Success

datasetArnstring required

The Amazon Resource Name (ARN) of the dataset.

datasetIdstring required

The unique identifier of the dataset.

status'CREATING' | 'UPDATING' | 'DELETING' | 'ACTIVE' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' required

The current status of the dataset.

deletedCountinteger required

The number of examples deleted.

updatedAtstring date-time required

The timestamp when the examples were deleted.