Skip to main content
PUT
PUT /v1/dataContracts

Update a Data Contract

Create a data contract or update it if it already exists, using PUT /v1/dataContracts with the full request body. Send the complete definition, not just the fields you want to change. To change only some fields, use PATCH with a JSON Patch array and the application/json-patch+json content type, as shown in the PATCH examples below.

Body Parameters

string
required
Name of the data contract. Must be unique.
object
required
Reference to the data asset this contract applies to.
string
Human-readable display name.
string
Description in Markdown format.
string
default:"Draft"
Contract status: Draft, In Review, Approved, Rejected, Deprecated, or Archived.
array
Expected column definitions. Each item follows the Column schema.
array
Semantics rules evaluated against the entity’s metadata when the contract is validated.
array
References to test cases that must pass.
object
Service level agreement expectations. Stored and shown on the contract.
string
Terms of use in Markdown format. Describes allowed/disallowed use cases and compliance requirements.
object
Security and access expectations. Stored and shown on the contract, but not enforced.
array
Owner references (users or teams).
array
Reviewer user references.
string
ISO 8601 date from which this contract is effective.
string
ISO 8601 date until which this contract is effective.
PUT /v1/dataContracts

Common Patch Operations


Error Handling