Web API

Press shift + S to search API reference.

Overview

Audit Log

Monitor audit log events within your organization.

The Audit Log Events API allows you to view and monitor real-time audit log events within your organization. This provides the ability for admins to review actions performed by members of your organization, including details such as the type of the action, who performed the action, and when the action was performed. The retention period for audit log events is 180 days from the time the action took place. Use cases may include:

  • Exporting events into a security information and event management system (SIEM) or other tool
  • Proactively identifying any suspicious activity or misuse of organization resources
  • General monitoring and insight about events occurring within an organization
A full list of supported audit log event types can be found here: Audit Log Event Types.
Example audit log events include:
  • Adding/removing collaborators
  • Creating/deleting/moving bases
  • Creating/deleting/modifying share links
  • Uploading/downloading attachments
Note: The audit log event types supported by this API are a subset of all possible Airtable actions and more audit log events will be added over time.

Not seeing an action that you would like to track? Please let your account team know.

Example Audit Log Event object
{
"id": "01FYFFDE39BDDBC0HWK51R6GPF",
"timestamp": "2022-02-01T21:25:05.663Z",
"action": "createBase",
"payloadVersion": "1.0",
"payload": {
"name": "My newly created base!"
},
"modelId": "app00000000000000",
"modelType": "base",
"actor": {
"type": "user",
"user": {
"id": "usr00000000000000",
"email": "foo@bar.com",
"name": "Jane Doe"
}
},
"origin": {
"ipAddress": "1.2.3.4",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/107.0.0.0 Safari/537.36"
},
"context": {
"enterpriseAccountId": "ent00000000000000",
"actionId": "act00000000000000",
"workspaceId": "wsp00000000000000",
"baseId": "app00000000000000",
"interfaceId": "pbd00000000000000"
}
}
The Audit Log Events API does not reflect changes to contents of cell values. If there is a need to monitor data being placed into cell values of Airtable bases, you may consider using our Data Loss Prevention solution through the Change Events API.