Sign in

v1

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

Updates multiple existing examples in-place on DRAFT. All examples are validated against the dataset's schema type before any writes occur. If any example fails validation, the entire batch is rejected (all-or-nothing semantics).

post/datasets/{datasetId}/examples/update

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>.

examplesSensitiveJson[] required

A list of dataset examples. Each element is a free-form JSON document whose structure is defined by the dataset's schema type.

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.

updatedCountinteger required

The number of examples updated.

updatedAtstring date-time required

The timestamp when the examples were updated.