TRtraversal
External API

List event logs

Changed on

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

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/v0/event-logs
  • Auth
    none declared

Query parameters

start_timestring date-time nullable

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).

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' | 'service_accounts.role_granted' | 'service_accounts.role_revoked' | 'auth.login' | 'auth.logout' | 'sessions.create' | 'sessions.update' | 'sessions.delete' | 'slack_channel_enrollments.create' | 'slack_channel_enrollments.update' | 'slack_channel_enrollments.delete' | 'chat_platform_channel_enrollments.create' | 'chat_platform_channel_enrollments.update' | 'chat_platform_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.

limitinteger nullable

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.

Changes

  • 53b6ebae31bcRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added the enum value chat_platform_channel_enrollments.create to the property anyOf[subschema #1: EventLogType]/ of the query request parameter type

    • info

      added the enum value chat_platform_channel_enrollments.delete to the property anyOf[subschema #1: EventLogType]/ of the query request parameter type

    • info

      added the enum value chat_platform_channel_enrollments.update to the property anyOf[subschema #1: EventLogType]/ of the query request parameter type

    • info

      added chat_platform_channel_enrollments.create chat_platform_channel_enrollments.delete chat_platform_channel_enrollments.update discriminator mapping keys to the / response property for the response status

  • 47dcc19b4addRevision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      added the enum value service_accounts.role_granted to the property anyOf[subschema #1: EventLogType]/ of the query request parameter type

    • info

      added the enum value service_accounts.role_revoked to the property anyOf[subschema #1: EventLogType]/ of the query request parameter type

    • info

      added service_accounts.role_granted service_accounts.role_revoked discriminator mapping keys to the / response property for the response status