Sign in

v1

latestOpenAPI 3.0.02026-07-23620132.5 KB
Audit logs

List organization audit logs

Gets a list of all audit log entries for the specified organization.

The audit log entries in the response are sorted by the triggeredAt property in descending order by default. You can use pagination to navigate through a large number of entries.

You can get the audit log entries only for organizations in which you have the "Admin" or "Owner" roles. Otherwise, you get the 403 error.

get/audit-logs/organization/{organizationId}

Path parameters

organizationIdinteger required

The ID of the organization.

Query parameters

string
OR
integer
OR
string[]
OR
integer[]

The identification of the teams for which you want to get the audit log entries. You can use either team IDs or team names.

The team name can contain any valid UTF8 symbols and spaces.

dateFromstring date

Use the dateFrom parameter to get audit log entries from the specified date or newer. Specify the date in the YYYY-MM-DD format.

dateTostring date

Use the dateTo parameter to get audit log entries until the specified date or older. Specify the date in the YYYY-MM-DD format.

string
OR
string[]

The list of events for which you want to get audit log entries. To specify multiple events, use the array notation like: GET /audit-logs/organization/{organizationId}?event[0]=key_created&event[1]=connection_created.

You can check the list of supported events with the API call GET /audit-logs/organization/{organizationId}/filters in the events array in the response.

string
OR
integer
OR
string[]
OR
integer[]

The identification of the users for whose actions you want to get the audit log entries. You can use either user IDs or user names.

The user name can contain any valid UTF8 symbols and spaces.

pg[offset]integer

The number of entities you want to skip before getting entities you want.

pg[limit]integer

The maximum number of entities you want to get in the response.

pg[last]integer

The last retrieved key. In response, you get only entries that follow after the key.

pg[sortBy]'createdAt' | 'triggeredAt' | 'eventName' | 'organization' | 'team' | 'actor' | 'targetId'

Specify the response property values that Make will use to sort the audit log entries in the response. The default is triggeredAt.

pg[sortDir]'asc' | 'desc'

The sorting order. It accepts the ascending and descending direction specifiers.

pg[returnTotalCount]boolean

Set to true to get also the total number of audit log entries in the response.

Response

Audit log entries for the specified organization.