---
title: "EventList"
description: "A page of events, newest first."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Trails API

A page of events, newest first.

## Fields

- `EventList.events` (array<object>, required)
  - `EventList.events.eventCategory` (string, required)
  - `EventList.events.eventId` (string, required)
    - format `uuid`
  - `EventList.events.eventName` (string, required) — The operation: CreateWidget, LookupEvents.
  - `EventList.events.eventSource` (string, required) — `<namespace>.ezghcloud.com`.
  - `EventList.events.eventTime` (string, required)
    - format `date-time`
  - `EventList.events.eventType` (string, required) — ApiCall, ServiceEvent or SignIn.
  - `EventList.events.eventVersion` (string, required) — "1.0".
  - `EventList.events.organizationId` (string, required)
    - format `uuid`
  - `EventList.events.readOnly` (boolean, required)
  - `EventList.events.region` (string, required)
  - `EventList.events.resources` (array<object>, required)
    - `EventList.events.resources.resourceName` (string, required)
    - `EventList.events.resources.type` (string, required) — Organization, Project, Widget…
  - `EventList.events.userIdentity` (object, required) — Who made the call.
    - `EventList.events.userIdentity.isRoot` (boolean, required)
    - `EventList.events.userIdentity.accessKeyId` (string | null, optional)
    - `EventList.events.userIdentity.invokedBy` (string | null, optional) — A service event's cause: the public namespace that made the change.
    - `EventList.events.userIdentity.principalId` (string | null, optional)
    - `EventList.events.userIdentity.sessionContext` (one of, optional)
      - one of: [SessionContext](/trails-api/schemas/SessionContext/), `null`
    - `EventList.events.userIdentity.type` (string | null, optional) — User, Bot, Root or EzghService.
    - `EventList.events.userIdentity.userName` (string | null, optional)
  - `EventList.events.additionalEventData` (object | null, optional)
  - `EventList.events.errorCode` (string | null, optional)
  - `EventList.events.errorMessage` (string | null, optional)
  - `EventList.events.projectId` (string | null, optional)
  - `EventList.events.requestId` (string | null, optional)
  - `EventList.events.requestParameters` (object | null, optional) — Path and query parameters and the body's top-level fields, secrets hidden.
  - `EventList.events.responseElements` (object | null, optional) — A successful write's identifiers.
  - `EventList.events.sourceIpAddress` (string | null, optional)
  - `EventList.events.userAgent` (string | null, optional)
- `EventList.nextCursor` (string | null, optional)


Source: https://docs.ezghcloud.com/trails-api/schemas/EventList/index.md