audit_log_list

A single item in the audit log represents both the beginning and end of the logged operation (represented by time_started and time_completed) so that clients do not have to find multiple entries and match them up by request ID to get the full picture of an operation. Because timestamps may not be unique, entries have also have a unique id that can be used to deduplicate items fetched from overlapping time intervals.

Audit log entries are designed to be immutable: once you see an entry, fetching it again will never get you a different result. The list is ordered by time_completed, not time_started. If you fetch the audit log for a time range that is fully in the past, the resulting list is guaranteed to be complete, i.e., fetching the same timespan again later will always produce the same set of entries.

get/v1/system/audit-log

Query Parameters

end_time

Exclusive

limit

Maximum number of items returned by a single call

page_token

Token returned by previous call to retrieve the subsequent page

sort_by

Supported set of sort modes for scanning by timestamp and ID

start_time

Required, inclusive

Responses

Object
items

list of items on this page of results

Audit log entry

Object
actor

auth_method

How the user authenticated the request. Possible values are "session_cookie" and "access_token". Optional because it will not be defined on unauthenticated requests like login attempts.

id

Unique identifier for the audit log entry

operation_id

API endpoint ID, e.g., project_create

request_id

Request ID for tracing requests through the system

request_uri

URI of the request, truncated to 512 characters. Will only include host and scheme for HTTP/2 requests. For HTTP/1.1, the URI will consist of only the path and query.

result

Result of the operation

Result of an audit log entry

source_ip

IP address that made the request

time_completed

Time operation completed

time_started

When the request was received

user_agent

User agent string from the request, truncated to 256 characters.

next_page

token used to fetch the next page of results (if any)