Skip to content
Developer docs
Docs menu

The record of governance and access events.

Read audit events

GET/v2/audit/events

Governance and access events, newest first, kept for 365 days. Requires tenant_admin and a key without Space restrictions. Needs no capability.

Capability No capability is checked.

Guide: Permissions

Parameters

NameInTypeDescription
cursorQueryDevCursorThe next_cursor of the previous page. Omit it to start from the first page.length 1..1024
limitQueryintegerHow many items a page holds at most: 1 to 100, 20 by default.1..100, default: 20
space_idQueryDevSpaceRefOnly events in this Space. default names your default Space, as it does in a path.length 1..256
key_idQueryDevIdEvents by this key, and governance events on it: issuance, revocation, and rotation.length 1..256
actor_idQueryDevIdOnly events by this principal.length 1..256

Responses

  • 200 application/json
FieldTypeDescription
dataRequiredDevAuditEvent[]The items on this page.
next_cursorDevCursorPass it as cursor to get the next page. Absent on the last page.

Error statuses

400 401 403 404 422 429 500 503 See Errors for the error shape and Error codes for what each code means.

Example request

curl
curl "https://api.mirabase.dev/v2/audit/events" \
  -H "Authorization: Bearer $MIRABASE_API_KEY"

Example response

json
{
  "data": [
    {
      "id": "<id>",
      "action": "<action>",
      "outcome": "allowed",
      "principal_id": "<principal_id>",
      "resource_kind": "<resource_kind>",
      "created_at": "2026-11-06T00:00:00Z"
    }
  ]
}