Events & Audit Log

Every significant action in the embed system is logged as an event. Use the events API to build audit trails, monitor activity, and debug issues.

This endpoint requires an oh_ API key with the embed:manage scope.

Querying Events


GET /api/v1/embed/events?page=1&limit=50&event_type=bridge.created&end_user_id=uuid
Authorization: Bearer oh_your-api-key

Query Parameters

Parameter	Description
`page`	Page number (default: 1)
`limit`	Results per page (default: 50)
`event_type`	Filter by event type
`end_user_id`	Filter by end user
`from`	Start date (ISO 8601)
`to`	End date (ISO 8601)

Response


{
  "data": [
    {
      "id": "uuid",
      "end_user_id": "uuid",
      "session_id": "uuid",
      "event_type": "bridge.created",
      "resource_type": "bridge",
      "resource_id": "bridge-uuid",
      "metadata": {
        "type": "shopify",
        "name": "My Store"
      },
      "ip_address": "192.168.1.1",
      "created_at": "2026-03-21T18:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 200,
    "totalPages": 4,
    "hasMore": true
  }
}

Event Types

Session Events

Event	Description
`session.created`	Manual session created via API
`session.auto_created`	Auto-session created via publishable key
`session.revoked`	Session revoked

Bridge Events

Event	Description
`bridge.created`	End user created a bridge
`bridge.updated`	Bridge configuration or status changed
`bridge.deleted`	End user deleted a bridge
`bridge.oauth_started`	OAuth flow initiated

User Events

Event	Description
`user.deleted`	End user record deleted

Action Request Events

Event	Description
`action_request.created`	End user submitted a request
`action_request.approved`	Request approved from dashboard
`action_request.denied`	Request denied from dashboard

Other Events

Event	Description
`alert_rule.created`	End user created an alert rule
`webhook.created`	End user registered a webhook
`tracking_page.created`	Tracking page token generated