v1

latestOpenAPI 3.1.0MIT2026-07-132429592.7 MB
Audit Logs

List user actions and configuration changes within this organization.

get/organization/audit_logs

Query parameters

gtinteger

Return only events whose effective_at (Unix seconds) is greater than this value.

gteinteger

Return only events whose effective_at (Unix seconds) is greater than or equal to this value.

ltinteger

Return only events whose effective_at (Unix seconds) is less than this value.

lteinteger

Return only events whose effective_at (Unix seconds) is less than or equal to this value.

Return only events whose effective_at (Unix seconds) is in this range.

project_ids[]string[]

Return only events for these projects.

event_types[]AuditLogEventType[]

Return only events with a type in one of these values. For example, project.created. For all options, see the documentation for the audit log object.

actor_ids[]string[]

Return only events performed by these actors. Can be a user ID, a service account ID, or an api key tracking ID.

actor_emails[]string[]

Return only events performed by users with these emails.

resource_ids[]string[]

Return only events performed on these targets. For example, a project ID updated.

limitinteger

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.

afterstring

A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.

beforestring

A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.

Response

Audit logs listed successfully.

object'list' required
first_idstring nullable
last_idstring nullable
has_moreboolean required

Example response

{
  "first_id": "audit_log-defb456h8dks",
  "last_id": "audit_log-hnbkd8s93s"
}