Skip to main content
GET
List the versions of a data asset, newest first

Authorizations

Authorization
string
header
required

Use a Bearer token for authentication. Submit the token using the Authorization header: Authorization: Bearer <token>.

Path Parameters

username
string
required

The username associated with the request.

namespace
string
required

Namespace for the dataset.

assetId
string<uuid>
required

The data asset's id.

Query Parameters

status
string

Which statuses to include, comma separated.

  • omitted entirely - committed only. The default, so an unaware caller never sees a half-written version.
  • status= (present but empty) - every status. Widening is explicit by design: there is no value that means "all" implicitly.
  • status=pending,committed - exactly those.

Unknown values are rejected with 422 rather than ignored, so a typo like status=commited fails loudly instead of silently returning nothing.

Response

The asset's versions

versions
object[]
required