Audit
MarkdownThe 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
| Name | In | Type | Description |
|---|---|---|---|
cursor | Query | DevCursor | The next_cursor of the previous page. Omit it to start from the first page.length 1..1024 |
limit | Query | integer | How many items a page holds at most: 1 to 100, 20 by default.1..100, default: 20 |
space_id | Query | DevSpaceRef | Only events in this Space. default names your default Space, as it does in a path.length 1..256 |
key_id | Query | DevId | Events by this key, and governance events on it: issuance, revocation, and rotation.length 1..256 |
actor_id | Query | DevId | Only events by this principal.length 1..256 |
Responses
200application/json
| Field | Type | Description |
|---|---|---|
dataRequired | DevAuditEvent[] | The items on this page. |
next_cursor | DevCursor | Pass 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 "https://api.mirabase.dev/v2/audit/events" \
-H "Authorization: Bearer $MIRABASE_API_KEY"Example response
{
"data": [
{
"id": "<id>",
"action": "<action>",
"outcome": "allowed",
"principal_id": "<principal_id>",
"resource_kind": "<resource_kind>",
"created_at": "2026-11-06T00:00:00Z"
}
]
}