Skip to main content
POST
POST /v1/dataContracts

Create a Data Contract

Create a new data contract and attach it to a data asset. Only the name and entity reference are required — all other sections (schema, semantics, quality, SLA, security, terms of use) are optional.

Body Parameters

name
string
required
Name of the data contract. Must be unique.
entity
object
required
Reference to the data asset this contract applies to.
displayName
string
Human-readable display name.
description
string
Description in Markdown format.
entityStatus
string
default:"Draft"
Contract status: Draft, Active, or Deprecated.
schema
array
Expected column definitions. Each item follows the Column schema.
semantics
array
Semantics rules defining business expectations.
qualityExpectations
array
References to test cases that must pass.
sla
object
Service level agreement expectations.
termsOfUse
string
Terms of use in Markdown format. Describes allowed/disallowed use cases and compliance requirements.
security
object
Security and access policy expectations.
owners
array
Owner references (users or teams).
reviewers
array
Reviewer user references.
effectiveFrom
string
ISO 8601 date from which this contract is effective.
effectiveUntil
string
ISO 8601 date until which this contract is effective.
POST /v1/dataContracts

Upsert (Create or Update)

Use PUT /v1/dataContracts with the same body to create a new contract or update an existing one.

Error Handling