Skip to main content
GET
List audit events

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Query Parameters

object_type
enum<string>

Only events about this kind of object.

Available options:
agent,
file,
session,
task,
key,
member,
invite,
webhook,
org,
billing
object_id
string

With object_type: only this object’s events, such as an agent’s agent_id or a session’s code.

actor_type
enum<string>

Only events by this kind of actor.

Available options:
user,
api_key,
agent,
customer,
session,
system
limit
integer
default:20

How many to return, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

Response

OK

data
object[]
required
has_more
boolean
required
next_cursor
string | null
required

Pass as cursor to get the next page.