Audit Log

Every significant action in Haltless is recorded in the audit trail. Query audit logs for compliance, debugging, and operational visibility.

List audit logs

GET /audit

Auth: Bearer JWT (any role)

Parameter	Type	Description
action	string	Filter by action (max 100 chars)
resource_type	string	Filter by resource type (max 100 chars)
page	int	Page number
page_size	int	Items per page (max 100)

curl "https://api.haltless.io/api/v1/audit?action=create_machine&page_size=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response:

{
  "items": [
    {
      "id": "uuid",
      "tenant_id": "uuid",
      "user_id": "uuid",
      "action": "create_machine",
      "resource_type": "machine",
      "resource_id": "uuid",
      "details": {"name": "CNC Mill #1", "identifier": "CNC-001"},
      "created_at": "2026-04-04T10:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 10
}

Tracked actions

Action	Resource type	Description
create_machine	machine	Machine registered
update_machine	machine	Machine details updated
delete_machine	machine	Machine soft-deleted
create_alert_rule	alert_rule	Alert rule created
acknowledge_alert	alert	Alert acknowledged
create_work_order	work_order	Work order created
update_work_order	work_order	Work order status changed
create_signoff	signoff	Digital sign-off recorded
create_api_key	api_key	API key generated
revoke_api_key	api_key	API key revoked
update_role_permissions	tenant	Role permissions changed
update_dashboard_presets	tenant	Dashboard presets saved
login_success	user	Successful login
login_failure	user	Failed login attempt
mfa_enabled	user	MFA activated