Web API

Press shift + S to search API reference.

Endpoint

Create audit log request

posthttps://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/auditLogs

NOTE: Use of this API is discouraged for new use cases. Prefer to use the audit log events API instead.

Create an audit log request. This starts the processing necessary to retrive the logs.

The response includes an id, which is then used to check the status of and download your logs.

Requirements

AuthenticationPersonal access token, OAuth integration
Scopeenterprise.auditLogs:read
User role

Enterprise admin

Billing plansAll plans

Path parameters

enterpriseAccountId
string

Request body

timePeriod
string

The time period (specific month or day) for which you want to retrieve audit logs for. Must be in either YYYY-MM or YYYY-MM-DD format and within the last 180 days.

filter
optional<string>

An optional filter may be supplied. The filter value may be any of:

  • User ID
  • Workspace ID
  • Base ID
  • Table ID
  • IPv4 address (1.2.3.4)

Response format

Audit log
Request (example)
Copy
$
curl -X POST "https://api.airtable.com/v0/meta/enterpriseAccounts/{enterpriseAccountId}/auditLogs" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
--data '{
"filter": "appLkNDICXNqxSDhG",
"timePeriod": "2021-01"
}'
200 – Response (example)
{
"createdByUserId": "usrL2PNC5o3H4lBEi",
"createdTime": "2021-01-01T00:00:00.000Z",
"filter": "appLkNDICXNqxSDhG",
"id": "ealLvFqm3oJNxg30m",
"state": "pending",
"timePeriod": "2021-01"
}