Skip to main content

Approve Diff

Approve a pending schema graph diff to record a human verdict that the ontology change is acceptable. Sets review_status to approved. Requires write scope.

Approve a schema graph diff to record a human verdict that the structural change between two class versions is acceptable. Approval sets the diff's review_status to approved and stamps who reviewed it and when, closing the item out of the pending review queue.

Approval is an audit action: the version the diff describes already exists, so approving does not modify the class structure. What it gives you is a reviewed ontology trail: every moderate or critical change to a document type carries an explicit human sign-off you can query later.

Review critical diffs carefully before approving: they contain field removals, incompatible type changes, or large structural reorganizations that may affect downstream consumers relying on the removed or changed fields.
POST/v1/schema-graph/diffs/{id}/approve

curl

Response

Response fields

idstringDiff UUID.
review_statusstringAlways `approved` on success.

Response

{
  "id": "diff-uuid-1",
  "review_status": "approved"
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
404not_foundNo diff with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

A typical review loop: list status=pending diffs, inspect each diff's added_fields, removed_fields, and type_changes, approve the acceptable ones, and reject the ones that flag noisy or incorrect field discoveries so they stay visible in the audit history as disputed.