Referencing Attributes via Project-Unique Slugs in API and Schema Workflows

Dynamic Entity-Attribute-Value (EAV) architectures rely on immutable UUID identifiers to map entity attributes across dynamic schemas. While UUIDs guarantee collision-free uniqueness across multi-tenant data structures, requiring raw database keys in client payloads introduces unnecessary friction. Application developers, ingestion scripts, and automated pipelines must execute pre-flight schema lookups or hardcode internal IDs into application code before transmitting data.

Omnismith resolves this coupling by introducing string-based attribute aliases through project-unique slugs. Attributes can now accept an optional slug (attribute_slug), allowing API write payloads, entity search filters, metric telemetry streams, and schema management workflows to reference fields using human-readable names.

Attribute Identifier Resolution

Attribute definitions can be assigned a slug during initial creation or through subsequent schema updates. Slugs are scoped to their active project, allowing different projects to use identical, intuitive slug names (such as sku or product_title) without collision.

When an API payload includes an attribute_slug field, Omnismith resolves the slug against the project’s attribute registry automatically. The primary attribute_id UUID remains fully supported across all endpoints.

{
  "template_id": "019fc909-e3f1-775b-9070-afb5acdf2360",
  "attribute_values": [
    {
      "attribute_slug": "product_title",
      "value": "Ergonomic Mechanical Keyboard"
    },
    {
      "attribute_slug": "sku",
      "value": "KB-ERG-01"
    }
  ]
}

The payload resolver evaluates attribute_slug whenever attribute_id is omitted. If both keys are present in a single attribute value object, attribute_id takes precedence to ensure deterministic execution for internal system workflows.

Entity Operations and Metric Ingestion

Support for attribute_slug references is integrated across core entity data paths:

• Entity Operations & Search: Entity creation (POST /entities), updates (PATCH /entities/{id}), and entity search filters (POST /entities/search/{template_id}) accept attribute_slug references directly in payload bodies and query filters.
• Metric Telemetry Ingestion: For high-frequency telemetry streams and hardware sensors, the metric ingestion endpoint (POST /entities/{id}/metrics) processes attribute_slug values directly within stream payloads:

{
  "metric_values": [
    {
      "attribute_slug": "warehouse_stock_level",
      "value": "84",
      "updated_at": "2026-08-07T09:30:00Z"
    }
  ]
}

During execution, telemetry payloads referencing slugs are resolved automatically and streamed directly into the metric store without performance penalties.

Platform and AI Assistant Integration

Slugs serve as surface-level references across all platform tools:

• Web Console UI: Attribute creation and configuration dialogs include dedicated input fields for slugs. In attribute directory tables, active slugs display as monospace badge tags to simplify copying identifiers into codebase configurations.
• AI Assistant Tooling: Schema scaffolding and modification tool calls support the slug property across schema generation functions. When generating or modifying project data models, the AI Assistant assigns standard snake_case slugs to created attributes automatically.

Scoping and Backward Compatibility

Attribute slugs are optional and can be introduced progressively into existing projects without breaking existing integrations.

• Project-Level Scoping: Slugs are enforced per project scope, so teams can use familiar naming conventions across separate projects without cross-project naming conflicts.
• Optimized Resolution: Slug resolution is cached per project, preserving low-latency execution paths across real-time writes and high-frequency telemetry streams.
• 100% Backward Compatibility: Existing integrations and scripts relying on internal UUIDs continue to function seamlessly.

By introducing project-unique attribute slugs, Omnismith eliminates identifier coupling, making dynamic schema integrations cleaner and far more approachable for developer teams and AI workflows alike.