Skip to main content

Register a definition

POST 
/registry/definitions

Register (create or update) a definition in the registry.

Definitions are immutable once published. If (definition_id, version) already exists with identical body, the existing record is returned. If it exists with a different body → HTTP 409 (immutability violation).

For concepts, meaning_hash and ir_hash are computed at registration time.

Requires elevated key (X-Elevated-Key header) → HTTP 403 if absent.

HTTP 403 — elevated key missing or invalid. HTTP 409 — definition already exists with different body.

Request​

Responses​

Successful Response