API referenceAudit

Get audit logs

Retrieve audit logs based on specified filters. Returns a paginated list of audit log entries.

The audit logs feature is available for Enterprise-tier organizations with single-tenant environments. To use this endpoint, you must have audit log access permissions. Contact Instabase Support to request access to audit logs for your organization.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
startinteger or nullOptional
Number of results to skip for pagination
sizeinteger or nullOptional
Maximum number of results to return
log_typestring or nullOptional

Type of audit log to filter by. Valid values include:

  • account: Account creation logs
  • acl: Workspace and group membership operation logs
  • apps: Automation app operation logs
  • app_deployment_run: Deployment run operation logs
  • app_deployment: Deployment operation logs
  • login: Member login and authentication logs
  • mount: Data connection operation logs
  • oauth2: OAuth token operation logs
  • org: Organization role change logs
  • org_secret: Organization secrets operation logs

For details about tracked operations, see Viewing audit logs.

emailstring or nullOptional
Filter logs by user email
start_timestring or nullOptional
Start time in epoch milliseconds
end_timestring or nullOptional
End time in epoch milliseconds

Response

Successfully retrieved audit logs
statusstring or null
dataobject or null