Query the audit trail
Returns a paginated, filterable audit log of user actions within the organisation. Useful for compliance (SOC 2) and governance reviews. **Required scope:** `org:audit:read`
Authorization
BearerAuth Security scheme for OpenAPI endpoints. Validates both JWT tokens and API keys.
In: header
Path Parameters
uuidQuery Parameters
Filter by category (auth, data, schema, organisation, user_management, api_key, storage, billing)
Filter by specific action (e.g. "data.query", "user.invited")
Filter by acting user ID
uuidFilter by resource type (e.g. "table", "user", "api_key")
Filter by resource ID
Filter by outcome (success, failure, denied)
Start of time range (ISO 8601)
End of time range (ISO 8601)
Maximum results to return (1-1000, default 100)
int64Number of results to skip (default 0)
int64Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/organisations/497f6eca-6276-4993-bfeb-53cbbbba6f08/audit"{ "events": [ { "id": "string", "organisationId": "string", "userId": "string", "userEmail": "string", "category": "string", "action": "string", "outcome": "string", "resourceType": "string", "resourceId": "string", "details": null, "ipAddress": "string", "userAgent": "string", "apiKeyPrefix": "string", "createdAt": "string" } ], "total": 0, "limit": 0, "offset": 0}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}{ "code": "string", "message": "string", "request_id": "string", "details": [ { "field": "string", "message": "string" } ]}