GET
/organization/audit_logsList audit logs
List user actions and configuration changes within this organization.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
effective_atobjectoptional
Return only events whose `effective_at` (Unix seconds) is in this range.
project_ids[]array<string>optional
Return only events for these projects.
event_types[]array<string>optional
Return only events with a `type` in one of these values. For example, `project.created`. For all options, see the documentation for the [audit log object](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/audit_logs).
actor_ids[]array<string>optional
Return only events performed by these actors. Can be a user ID, a service account ID, or an api key tracking ID.
actor_emails[]array<string>optional
Return only events performed by users with these emails.
resource_ids[]array<string>optional
Return only events performed on these targets. For example, a project ID updated. For ChatGPT connector role events, use the workspace connector resource ID shown in `details.id`, such as `<workspace_id>__<connector_id>`.
tenant_onlybooleanoptional
Return only tenant-scoped events associated with this organization. Required for tenant-scoped events such as `role.bound_to_resource` and `role.unbound_from_resource`. When `true`, all supplied event types must be tenant-scoped.
limitintegeroptional
A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20.
afterstringoptional
A cursor for use in pagination. `after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list.
beforestringoptional
A cursor for use in pagination. `before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.
200Audit logs listed successfully.
objectstringrequired
dataarray<object>required
first_idstringoptional
last_idstringoptional
has_morebooleanrequired
429The request was rejected because a rate limit was exceeded.
errorobjectrequired
Error handling
A 429 is returned: The request was rejected because a rate limit was exceeded.