List Event Types
GET {{baseUrl}}/logs/activitytypes
Return a list of queryable audit event types in the account of the API client.
Activity Types
The
activityTypes
object shows the accepted activity type query params that can be used in the Get Activity Log endpoint (see: List Events). TheadditionalFilters
property shows what query parameters can be used for the specific activity type. Thefilters
anddisplayOptions
can be applied to any activity type.
There are several different types of audit events, and you can find an example collection in the result example below.
Log Type | Use |
---|---|
Logins | View regular, proxy, SSO, and Failed logins. |
Password Changes | Any time a user changes their own password in the Account Settings page. |
Password Resets | Whenever a password is reset. This includes users choosing Forgot Your Password? on the login page, Brand Admins sending password resets, or the user having to change their password because the password expired or you set new minimum requirements. |
Session Creations | Any time an account is logged into, thus creating a new session. This is different from Logins because it doesn’t count failures or allow you to check for proxies. If you click a user, it will show when the session ended. |
Session Terminations | Every time a session terminates, either because a user logged out or an administrator forced them to. To see which, click the termination and look at the Reason field. |
Users | Any time a user is created or deleted. Event Type will be Deleted for deleted users. Click a user for more information, such as their username before they were terminated. |
API Access | View a user's API requests. You will find the transaction id for each call in the returned JSON. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"result":{"elements":[{"name":"logins","additionalFilters":["organizationId","userId"]},{"name":"session_creations","additionalFilters":["organizationId","userId"]},{"name":"session_terminations","additionalFilters":["organizationId","userId"]},{"name":"password_changes","additionalFilters":["organizationId","userId"]},{"name":"password_resets","additionalFilters":["organizationId","userId"]},{"name":"users","additionalFilters":["organizationId","userId"]},{"name":"brands","additionalFilters":["organizationId"]},{"name":"role_membership_change","additionalFilters":["organizationId"]},{"name":"role_permission_change","additionalFilters":["organizationId"]},{"name":"user_permission_change","additionalFilters":["organizationId","userId"]},{"name":"contact_list","additionalFilters":["organizationId","directoryId","groupId","userId"]},{"name":"contact","additionalFilters":["organizationId","directoryId","contactId","userId"]},{"name":"directory","additionalFilters":["organizationId","directoryId","userId"]},{"name":"directory_setting","additionalFilters":["organizationId","directoryId","userId"]},{"name":"dashboard_usage","additionalFilters":["organizationId","userId","dashboardId"]},{"name":"api_access","additionalFilters":["organizationId","userId"]}]},"meta":{"requestId":"8267c159-c9f5-4e92-a0f4-c53b5bb2d666","httpStatus":"200 - OK"}}