knowledge module route (requires knowledge:data_product:write)

POST

/v1/m/knowledge/data-products/{id}/contracts

curl --request POST \
  --url https://example.com/v1/m/knowledge/data-products/example/contracts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "completeness_threshold": 1, "freshness_override_seconds": 1, "note": "example", "schema_definition": {}, "validation_mode": "" }'

• this engine

Creates one data contract version for a data product.

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Path parameter id.

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

Request Body ^required

Media type application/json

object

completeness_threshold

integer format: int64

<= 100

freshness_override_seconds

integer format: int64

note

Notes containing a recognized secret are rejected.

string

<= 200 characters

schema_definition

Any of:

object

A JSON Schema object. The encoded value is limited to 64 KiB by the handler.

object

key

additional properties

any

null

null

validation_mode

Empty defaults to strict when a non-empty schema exists, otherwise none.

string

Allowed values: "" strict lenient none

Responses

200

OK

Media type application/json

object

Example ^generated

{}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict / setup required

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}