Skip to content
Hantera OMS Developer Portal Developer Portal

2025.3

Platform & Core

Checkpoints & Rewind API Feature

All actors now support checkpoints and rewind through two new messages: getCheckpoints and rewind. Every time commands are applied to an actor, a checkpoint is automatically created, forming a complete history of all state changes.

Key capabilities include:

  • View historical states — Retrieve all checkpoints for any actor and preview what the actor looked like at any point in time using preview mode
  • Non-destructive rewind — Restore an actor to a previous checkpoint while preserving the full mutation history. The rewind itself becomes a new checkpoint, so you can even rewind a rewind
  • Preview-only permissions — A dedicated rewind:preview permission allows support personnel to investigate historical states without the ability to modify data

Learn more about Checkpoints & Rewind →

Sendings Resource Class Feature

A new Sendings resource class provides a centralized communication queue for delivering emails, with SMS and push notifications planned for the future. Sendings track each message through its entire delivery lifecycle — from pending through sent or bounced — with automatic retries and rate limiting.

Sendings can be created via the Filtrera sendEmail function in components and rules, or through the REST API for external integrations. Custom data can be attached to sendings and queried through the Graph API for analytics and monitoring.

Learn more about Sendings →

Audit Logs Feature

A new audit logging system has been introduced, providing system-level traceability of actions across the platform. Audit logs track who performed what actions and when, enabling compliance monitoring, security auditing, and operational troubleshooting.

IAM APIs and Portal UI Feature

The Identity & Access Management system now includes comprehensive REST APIs and portal UI for managing identities, roles, and permissions.

Key capabilities include:

  • Principal management — Create, update, suspend, and delete user identities with role assignments
  • Client management — Configure OAuth clients for application and service-to-service authentication
  • Role management — Define custom roles with granular permission sets
  • ETag-based concurrency — Safe concurrent updates using If-Match headers to prevent conflicting modifications

Learn more about IAM →

Event Streaming API Feature

A new WebSocket-based event streaming API enables real-time notifications about changes in your system. Connect to the /events endpoint to receive live events as they happen.

Supported event sources include:

  • Jobs — Track job lifecycle events (scheduled, started, completed, failed)
  • Job statistics — Live aggregated counters per job definition (success/failure rates, execution times)
  • Actors — Receive checkpoint events when orders, payments, SKUs, tickets, or assets change

The API uses subscription-based filtering so clients only receive the events they need, with built-in keep-alive and backpressure handling.

Learn more about Event Streaming →

Graph

anyof Operator for All Fields Improvement

The anyof filter operator can now be used on scalar fields in addition to array fields. Previously, anyof was limited to array fields. This enables more flexible filtering — for example, matching orders where a single-value field equals any of several candidates:

orderState anyof ['pending', 'confirmed']

Portal

Rewind from Order Timeline Feature

Orders can now be rewound to a previous checkpoint directly from the order view’s visual timeline in the portal. This provides an intuitive way for operators to view an order’s history and restore it to an earlier state when needed, without leaving the order view.

Portal User Profile Feature

A new user profile page has been added to the portal, allowing users to manage their personal information:

  • Profile picture and display name
  • Email address — Change the email used for login
  • Password — Update login password

Jobs Statistics and Management Views Feature

New portal views and APIs for monitoring and managing jobs:

  • Statistics dashboard — View job execution metrics including success/failure rates, execution times, and trends per job definition
  • Job management — Browse, inspect, cancel, and retry jobs directly from the portal
  • Statistics API — Programmatic access to job statistics for building custom dashboards and alerting

Live App Development Feature

The Hantera CLI now supports a live development mode for apps. When connected to a Hantera instance, all server-side app changes — components, job definitions, registry entries, rules, and more — are published in real-time as you save files.

This complements the existing Vite-based portal development mode (for UI) by adding live development for all backend aspects of an app. When you disconnect from the development session, all app resources are automatically cleaned up.