Get audit logs | Instabase AI Hub Documentation

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

This API operation is available for Enterprise-tier organizations with single-tenant environments. To use it you must have audit log access permissions. Contact Instabase Support to request access to audit logs for your organization.

This API operation is not supported by the SDK but you can access it from Python by making direct REST calls, as shown in the sample code.

Retrieve audit logs based on specified filters. Returns a paginated list of audit log entries. <Note>This API operation is available for Enterprise-tier organizations with single-tenant environments. To use it you must have audit log access permissions. Contact Instabase Support to request access to audit logs for your organization.</Note> <Note>This API operation is not supported by the SDK but you can access it from Python by making direct REST calls, as shown in the sample code.</Note>

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_v2: User account creation logs
api_v2: API request logs
app_deployment_run_v2: Deployment run operation logs
app_deployment_v2: Deployment operation logs
app_v2: Automation app operation logs
datasource_v2: Data connection operation logs
login_v2: User login and authentication logs
oauth2_v2: OAuth token operation logs
org_v2: Organization role change logs
org_secrets_v2: Organization secrets operation logs
perms_v2: Membership and role change logs, for the organization, workspaces, and groups
projects_v2: Automation project operation logs
review_v2: Human review operation logs
workspace_v2: Workspace management operation logs

For details about tracked operations, see Viewing audit logs.

Type of audit log to filter by. Valid values include: - `account_v2`: User account creation logs - `api_v2`: API request logs - `app_deployment_run_v2`: Deployment run operation logs - `app_deployment_v2`: Deployment operation logs - `app_v2`: Automation app operation logs - `datasource_v2`: Data connection operation logs - `login_v2`: User login and authentication logs - `oauth2_v2`: OAuth token operation logs - `org_v2`: Organization role change logs - `org_secrets_v2`: Organization secrets operation logs - `perms_v2`: Membership and role change logs, for the organization, workspaces, and groups - `projects_v2`: Automation project operation logs - `review_v2`: Human review operation logs - `workspace_v2`: Workspace management operation logs For details about tracked operations, see [Viewing audit logs](/admin/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

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

account_v2: User account creation logs
api_v2: API request logs
app_deployment_run_v2: Deployment run operation logs
app_deployment_v2: Deployment operation logs
app_v2: Automation app operation logs
datasource_v2: Data connection operation logs
login_v2: User login and authentication logs
oauth2_v2: OAuth token operation logs
org_v2: Organization role change logs
org_secrets_v2: Organization secrets operation logs
perms_v2: Membership and role change logs, for the organization, workspaces, and groups
projects_v2: Automation project operation logs
review_v2: Human review operation logs
workspace_v2: Workspace management operation logs

For details about tracked operations, see Viewing audit logs.

1	# SDK does not support this operation, so you
2	# must make REST calls using "requests" module
3	import requests
4
5	url = "https://aihub.instabase.com/api/v1/auditlogs"
6	headers = { "Authorization": "Bearer abcdefghijklmnopqrst1234567890",
7	"Content-Type": "application/json" }
8
9	# create the request payload
10	data = { "log_type": "org_secret",
11	"size": 50,
12	"start_time": "1749139277810",
13	"start": 200 }
14
15	# make the POST request
16	response = requests.post(url,
17	headers=headers,
18	json=data)
19
20	# handle the response
21	if response.status_code == 200:
22	audit_logs = response.json()
23	print(f"Retrieved {len(audit_logs['data']['results'])} audit logs")
24	else:
25	print(f"Error: {response.status_code} - {response.text}")

1	{
2	"status": "OK",
3	"data": {
4	"results": [
5	{
6	"timestamp_millis": "timestamp_millis",
7	"email": "email",
8	"user_ip": "user_ip",
9	"log_type": "log_type"
10	}
11	]
12	}
13	}

Headers

Request

Response