API ReferenceAudit Logs

Get audit log entries for a specified User

Fetch audit logs for a given user with some filtering capabilities via query params. It works best to think of this as an activity log for the specified user

Path parameters

user_idstringRequired

Query parameters

filters[start_date]stringOptionalformat: "date"
Start ISO Date
filters[end_date]stringOptionalformat: "date"
End ISO Date
filters[resource_type]enumOptional
Filter by Resource Type
filters[event_type]enumOptional
Filter by Type of Activity
filters[team_id]stringOptionalformat: "uuid"
Filter by Team ID
filters[project_id]stringOptionalformat: "uuid"
Filter by Project ID
filters[resource_id]stringOptionalformat: "uuid"

Filter by resource ID (Asset ID, Project ID, User ID)

filters[user_id]stringOptionalformat: "uuid"
Filter by User ID
filters[ip_address]stringOptional
Filter by IP Address
pageintegerOptionalDefaults to 1
Page number
page_sizeintegerOptional<=200Defaults to 50
Records per page

Response

Succesful Event logs response
account_idstring or nullOptionalformat: "uuid"
anonymous_user_idstring or nullOptionalformat: "uuid"
clientstring or nullOptional

The API client the audit event was triggered by. This will not always be populated.

When the API call that produced an event was made via an OAuth app it will look like: oauth_app/:uuid, and if it was made via a developer token it will look like: user_token/:uuid, with the UUID being the User ID the token belongs to

Here are some examples:

  • user_token/57823879-e541-49b0-b902-c43794c4400c
  • oauth_app/80ccf0bb-ae91-49c4-8aec-8f6238c14947
  • web/2024-06-10-18-15
  • pipeline-media-warden/cbd0061f6f190489e8af3137b8707b33f498f53f
  • null
event_typeenumOptional
event_detailsobjectOptional
The details for the event. This varies quite a bit from one type of event to another but there are some examples in the example responses.
iddoubleOptional
Unique identifier
inserted_atstringOptionalformat: "date-time"
ip_addressstring or nullOptional
The IP address associated with this event
project_idstring or nullOptionalformat: "uuid"
The Project ID that this action occured in
resource_idstringOptionalformat: "uuid"
The ID of the referenced resource
resource_typeenumOptional
The type of the referenced resource
team_idstring or nullOptionalformat: "uuid"
Team ID
sourceenumOptional
The Source of the action that produced a given audit log entry
user_idstring or nullOptionalformat: "uuid"
User ID
updated_atstringOptionalformat: "date-time"

Errors

401
Unauthorized Error
404
Not Found Error