Query audit logs for all actions performed within an organization. Audit logs are immutable and retained according to your plan.
Method Path Description GET /api/audit-logsList audit logs
{ "id" : "aud_abc123" , "action" : "source.created" , "entityType" : "source" , "entityId" : "11111111-1111-4111-8111-111111110004" , "entityName" : "GitHub Webhooks" , "userId" : "33333333-3333-4333-8333-333333333333" , "userEmail" : "admin@example.com" , "userDisplayName" : "John Doe" , "metadata" : { "name" : "GitHub Webhooks" , "slug" : "github" , "provider" : "github" }, "ipAddress" : "192.168.1.1" , "userAgent" : "Mozilla/5.0..." , "createdAt" : "2024-01-15T10:30:00Z" } Parameter Type Description page number Page number (default: 1) pageSize number Items per page (default: 50, max: 100) action string Filter by action type (e.g., source.created) entityType string Filter by entity type (e.g., source) userId string Filter by user who performed the action from string Start date (ISO 8601) to string End date (ISO 8601)
curl JavaScript Python
# Get all audit logs curl https://api.hookbase.app/api/audit-logs \ -H "Authorization: Bearer whr_your_api_key"
# Filter by action curl "https://api.hookbase.app/api/audit-logs?action=source.deleted" \ -H "Authorization: Bearer whr_your_api_key"
# Filter by entity type and date range curl "https://api.hookbase.app/api/audit-logs?entityType=route&from=2024-01-01&to=2024-01-31" \ -H "Authorization: Bearer whr_your_api_key" { "logs" : [ { "id" : "aud_abc123" , "action" : "source.created" , "entityType" : "source" , "entityId" : "11111111-1111-4111-8111-111111110004" , "entityName" : "GitHub Webhooks" , "userId" : "33333333-3333-4333-8333-333333333333" , "userEmail" : "admin@example.com" , "createdAt" : "2024-01-15T10:30:00Z" }, { "id" : "aud_def456" , "action" : "route.updated" , "entityType" : "route" , "entityId" : "44444444-4444-4444-8444-444444440001" , "entityName" : "GitHub to Slack" , "userId" : "33333333-3333-4333-8333-333333330001" , "userEmail" : "dev@example.com" , "createdAt" : "2024-01-15T10:25:00Z" } ], "total" : 234 , "limit" : 50 , "offset" : 0 } Action Description source.createdSource created source.updatedSource settings updated source.deletedSource deleted source.secret_rotatedSigning secret rotated source.importedSources imported from file source.exportedSources exported
Action Description destination.createdDestination created destination.updatedDestination settings updated destination.deletedDestination deleted destination.testedTest webhook sent destination.importedDestinations imported destination.exportedDestinations exported
Action Description route.createdRoute created route.updatedRoute settings updated route.deletedRoute deleted route.pausedRoute paused route.resumedRoute resumed route.circuit_resetCircuit breaker manually reset route.importedRoutes imported route.exportedRoutes exported
Action Description organization.updatedOrganization settings updated organization.member_addedMember added organization.member_removedMember removed organization.member_role_changedMember role changed organization.invite_createdInvite sent organization.invite_acceptedInvite accepted
Action Description api_key.createdAPI key created api_key.revokedAPI key revoked auth.loginUser logged in auth.login_failedFailed login attempt auth.2fa_enabledTwo-factor authentication enabled auth.2fa_disabledTwo-factor authentication disabled auth.password_changedPassword changed
Action Description transform.createdTransform created transform.updatedTransform updated transform.deletedTransform deleted filter.createdFilter created filter.updatedFilter updated filter.deletedFilter deleted schema.createdSchema created schema.updatedSchema updated schema.deletedSchema deleted custom_domain.createdCustom domain added custom_domain.verifiedCustom domain verified custom_domain.deletedCustom domain removed notification_channel.createdNotification channel created notification_channel.deletedNotification channel deleted
Entity Type Description sourceWebhook source destinationWebhook destination routeRoute transformTransform filterFilter schemaSchema organizationOrganization api_keyAPI key custom_domainCustom domain notification_channelNotification channel cron_jobCron job tunnelTunnel authAuthentication event