Analytics

Search enterprise audit-log events

Returns the audit-log events of the caller's enterprise team: who did what, to which resource, and how access changed.

Authenticates via API key (X-Magnific-API-Key header). The caller's enterprise team and identity are resolved automatically from the API key.

Available exclusively for Enterprise plans with audit logs enabled, and only to team admins/owners. Rate limit: 500 RPD.

Retention & paging:

  • The audit index retains at most 30 days; the query window cannot exceed 30 days and defaults to the last 30 days when no dates are given.
  • per_page is capped at 100. In page mode, page * per_page cannot exceed 10000 (400 otherwise) — use cursor for deep iteration.
  • When cursor is provided, page is ignored and there is no depth limit. Follow meta.next_cursor until it is null to walk the whole history.

Reading your own audit trail costs no credits.

get/v1/analytics/audit-logs/events

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/analytics/audit-logs/events
  • Auth: API key in header x-magnific-api-key

Query parameters

pageinteger

Page number (1-based). Ignored when cursor is set.

per_pageinteger

Items per page (max 100).

date_fromstring date
Example:2026-07-16

Start of the query window (YYYY-MM-DD). Defaults to 30 days ago. Window max 30 days.

date_tostring date
Example:2026-07-31

End of the query window (YYYY-MM-DD). Defaults to today.

member_idinteger[]

Filter by actor user ID(s). Accepts a single value, a comma-separated list (member_id=1,2) or repeated params (member_id[]=1&member_id[]=2).

group_idinteger[]

Filter by team group ID(s). Same multi-value syntax as member_id.

folder_idstring[]

Filter by folder reference(s). Same multi-value syntax as member_id.

event_typestring[]

Filter by event type(s). Same multi-value syntax as member_id.

request_idstring

Exact request_id lookup — returns all events emitted by one request.

cursorstring

Opaque cursor for deep iteration. When set, page is ignored and there is no depth limit. Take the value from meta.next_cursor of the previous response.

Response

OK

Example response

{
  "data": [
    {
      "date": "2026-07-30T09:14:52Z",
      "event_id": "b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f",
      "member": {
        "user_id": 10499812,
        "type": "user",
        "email": "admin@company.com"
      },
      "action": {
        "data": {
          "target_user_id": 10511077,
          "role": "admin",
          "operation": "grant"
        },
        "verb": "update",
        "folder_name": "Q4 assets",
        "project_name": "Marketing Campaign Q4",
        "duration_ms": 42,
        "event_type": "team.member.role_changed",
        "old_state": {
          "role": "member"
        },
        "context": {},
        "resource_id": "18422",
        "correlation_id": "corr-2b8e",
        "new_state": {
          "role": "admin"
        },
        "request_id": "req-7f3a9c1e",
        "status": "success"
      },
      "source": {
        "referer": "referer",
        "project": "magnific",
        "platform": "web"
      },
      "category": "member"
    },
    {
      "date": "2026-07-30T09:14:52Z",
      "event_id": "b3d1f0a2-9c4e-4a1b-8f2d-1a2b3c4d5e6f",
      "member": {
        "user_id": 10499812,
        "type": "user",
        "email": "admin@company.com"
      },
      "action": {
        "data": {
          "target_user_id": 10511077,
          "role": "admin",
          "operation": "grant"
        },
        "verb": "update",
        "folder_name": "Q4 assets",
        "project_name": "Marketing Campaign Q4",
        "duration_ms": 42,
        "event_type": "team.member.role_changed",
        "old_state": {
          "role": "member"
        },
        "context": {},
        "resource_id": "18422",
        "correlation_id": "corr-2b8e",
        "new_state": {
          "role": "admin"
        },
        "request_id": "req-7f3a9c1e",
        "status": "success"
      },
      "source": {
        "referer": "referer",
        "project": "magnific",
        "platform": "web"
      },
      "category": "member"
    }
  ],
  "meta": {
    "next_cursor": "eyJzIjpbMTcyMjMyOF19",
    "pagination": {
      "per_page": 1,
      "total": 1,
      "last_page": 1,
      "current_page": 1
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.