Sign in
latestOpenAPI 3.1.02026-08-223321,1001.6 MB

2134ebffd1ef

External API

List event logs

List audit events for your organization. Platform admin role required. Filter by time range (start_time / end_time) and event type (type=<resource>.<action>). Pagination uses page + limit.

get/v0/event-logs

Query parameters

start_timestring date-time nullable

Inclusive lower bound on the event timestamp (ISO-8601, UTC).

Inclusive lower bound on the event timestamp (ISO-8601, UTC).

end_timestring date-time nullable

Exclusive upper bound on the event timestamp (ISO-8601, UTC).

Exclusive upper bound on the event timestamp (ISO-8601, UTC).

type'integrations.create' | 'integrations.update' | 'integrations.delete' | 'api_keys.create' | 'api_keys.delete' | 'users.invite_sent' | 'users.invite_accepted' | 'users.role_granted' | 'users.role_revoked' | 'users.archive' | 'auth.login' | 'auth.logout' | 'sessions.create' | 'sessions.update' | 'sessions.delete' | 'slack_channel_enrollments.create' | 'slack_channel_enrollments.update' | 'slack_channel_enrollments.delete'

Stable, dotted <resource>.<action> identifiers for every event the external /v0/event-logs API can emit. Values are part of the public contract — never rename or repurpose an existing entry.

TODO(PRD-2928): derive this enum from a single ChangeType -> {ChangeAction} mapping so adding a new exposed event only requires one edit, not four (this enum, the *Log variant, the to_event_log dispatch, and the OpenAPI enum block in the docs repo). See https://linear.app/traversal/issue/PRD-2928.

Dotted <resource>.<action> filter. See EventLogType for the full set.

pageinteger nullable

1-indexed page number.

1-indexed page number.

limitinteger nullable

Page size (max 100).

Page size (max 100).

Response

Successful Response

countinteger required

Number of rows returned on this page.

totalinteger required

Total rows matching the filters across all pages.

previnteger nullable

Previous page number, or null at the start.

nextinteger nullable

Next page number, or null at the end.