Skip to main content
Save a new immutable data version with an exact current-version check

Authorizations

Authorization
string
header
required

Opaque control credential

Headers

Idempotency-Key
string
required
Required string length: 8 - 128
Pattern: ^[A-Za-z0-9._:-]+$

Path Parameters

projectId
string
required
Pattern: ^prj_[0-9a-z]{12,32}$
datasetId
string
required
Pattern: ^dataset_[0-9a-f]{12,32}$

Body

application/json
expectedVersion
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
expectedDigest
string
required
Pattern: ^sha256:[0-9a-f]{64}$
source
object
required
collections
object[]
required
Maximum array length: 2048
name
string
Required string length: 1 - 160

Response

Original revision receipt

dataset
object
required
revision
object
required
provenance
object
required
revisionCreatedBy
string
required
Required string length: 1 - 255
revisionCreatedAtMs
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
replayed
boolean
required