English Docs
API Console

Management API

Audit Logs

View as Markdown
Create API key Learn Grok 4.7

List audit events

/audit/teams/{teamId}/events

API endpoint for GET requests to /audit/teams/{teamId}/events.

Path Parameters

teamIdstring

The team id to get events for.

Query Parameters

pageSizeinteger

The number of events to list per page.

pageTokenstring

When querying the next page, the offset token.

eventFilter.userIdstring

Filter events to this user only.

eventFilter.querystring

A general search term that is used for full-text description search.

eventFilter.eventIdstring

Search for a specific event by id.

eventTimeFromstring

Filter events from and/or to certain time (optional).

eventTimeTostring

orderBy"TIME_ASCENDING" | "TIME_DESCENDING"

Response Body

eventsarray<object>

Requested events. Ordered by event_time.

nextPageTokenstring

If there are more events, the token to be used to retrieve the next page of the search results.

Exampletext

text

No parameters.
Exampletext

text

{
  "events": [
    {
      "eventTime": "2025-01-15T10:30:00Z",
      "eventId": "550e8400-e29b-41d4-a716-446655440000",
      "description": "API key 'Production Key' was created",
      "user": {
        "userId": "user-123",
        "email": "admin@example.com",
        "givenName": "John",
        "familyName": "Doe"
      }
    }
  ],
  "nextPageToken": "550e8400-e29b-41d4-a716-446655440000"
}

Last updated:February 13, 2026