Apiome Primitives
Reusable, validated JSON Schema type definitions — the base building blocks for every class and property.
Apiome Primitives is the library of typed, reusable schema definitions that classes and properties are built from. Author them in a split-pane editor with live JSON Schema preview, import them from existing specs, and lean on locked system primitives for the standards you never want to redefine.
What ships with Primitives
Every Primitives surface is wired into the rest of the Apiome platform — no glue code, no separate identity, no bolt-on integrations.
Split-pane editor
Build a primitive on the left while the exact JSON Schema renders live on the right — no stacked modals.
Visual category picker
Icon cards for string, number, integer, boolean, array, and object make the base type obvious at a glance.
Live AJV validation
A Valid / Invalid status badge validates every schema against AJV as you type.
Expandable schema rows
Click any catalog row to expand its full JSON Schema inline without leaving the list.
System primitive lock
Standards like email, UUID, and ISO date-time ship read-only, with tooltips that explain why they can't be edited.
Schema import wizard
Pull definitions from a file, URL, or pasted JSON/YAML, cherry-pick what you need, and review before importing.
A look inside Apiome Primitives
Live design previews from the Primitives mockup pack — 3 surfaces in total.
Catalog with KPI band, search, category pills, a system toggle, and rows that expand to reveal their JSON Schema inline.
Three-step import wizard: choose a source by file drop, URL, or pasted JSON/YAML, select definitions, then review and import.
Use cases
Primitives is designed around the way real teams actually work — not the way a tool wants them to work.
Define a tenant-specific billing_status enum once and reuse it across every project that needs it.
Ship a curated set of locked system primitives so every team models emails, IDs, and dates the same way.
Import an existing OpenAPI component library and turn its definitions into reusable primitives in three steps.
- Locked, org-wide system primitive libraries
- Governed tenant vs. system primitive separation
- Usage analytics showing where each primitive is referenced
- Bulk import from existing OpenAPI and JSON Schema specs
- Change-controlled edits with validation gates
- Generate a constrained schema from a natural-language description
- Infer patterns and formats from example values
- Recommend an existing primitive instead of a duplicate
- Explain and repair invalid schema constraints
AI that drafts primitives from intent
Describe the value you need to model and Primitives proposes a fully-constrained JSON Schema, complete with format, pattern, and boundary rules ready to validate.
Every PrimitivesAI feature is grounded in your tenant's data, runs under your data-residency policy, and respects every role and ACL the platform enforces.
Every surface in Apiome Primitives
A look at the 3 screens designed for this suite — covering everything from day-1 onboarding to day-100 operations.
