v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141891,2951.1 MB

Creates a revision of the asset.

Asset revisions represent new versions of existing assets, capturing changes to either the underlying data or its metadata. They maintain a historical record of how assets evolve over time, who made changes, and when those changes occurred. This versioning capability is crucial for governance and compliance, allowing organizations to track changes, understand their impact, and roll back if necessary.

Prerequisites:

  • Asset must already exist in the domain with identifier.

  • formsInput is required when asset has the form type. typeRevision should be the latest version of form type.

  • The form content must include all required fields (e.g., bucketArn for S3ObjectCollectionForm).

  • The owning project of the original asset must still exist and be active.

  • User must have write access to the project and domain.

post/v2/domains/{domainIdentifier}/assets/{identifier}/revisions

Path parameters

domainIdentifierstring required

The unique identifier of the domain where the asset is being revised.

identifierstring required

The identifier of the asset.

Request body

namestring password required

Te revised name of the asset.

typeRevisionstring

The revision type of the asset.

descriptionstring password

The revised description of the asset.

glossaryTermsGlossaryTermId[]

The glossary terms to be attached to the asset as part of asset revision.

clientTokenstring

A unique, case-sensitive identifier that is provided to ensure the idempotency of the request.

Response

Success

idstring required

The unique identifier of the asset revision.

namestring password required

The revised name of the asset.

typeIdentifierstring required

The identifier of the revision type.

typeRevisionstring required

The revision type of the asset.

externalIdentifierstring

The external identifier of the asset.

revisionstring required

The revision of the asset.

descriptionstring password

The revised asset description.

createdAtstring date-time

The timestamp of when the asset revision occured.

createdBystring

The Amazon DataZone user who performed the asset revision.

firstRevisionCreatedAtstring date-time

The timestamp of when the first asset revision occured.

firstRevisionCreatedBystring

The Amazon DataZone user who performed the first asset revision.

glossaryTermsGlossaryTermId[]

The glossary terms that were attached to the asset as part of asset revision.

governedGlossaryTermsGlossaryTermId[]

The glossary terms in a restricted glossary.

owningProjectIdstring required

The unique identifier of the revised project that owns the asset.

domainIdstring required

The unique identifier of the Amazon DataZone domain where the asset was revised.