Skip to content

List tenant audit events.

Method

GET https://papi.afi.ai/api/v1/tenants/{tenant_id}/audit/events

Description

Retrieves audit events for the specified tenant. Use the limit and page_token query parameters to paginate through all events.

Path params
tenant_id string required

ID of the tenant whose events to list.

Query params
limit int32

Maximum number of items to return per page.

page_token string

Token from the previous list operation (`next_page_token`) used to continue listing.

start_time date-time

Start of the time range for retrieving audit events. Use RFC 3339 format.

end_time date-time

End of the time range for retrieving audit events. Use RFC 3339 format.

curl -X GET \
    -H 'Authorization: {api-key}' \
    https://papi.afi.ai/api/v1/tenants/{tenant_id}/audit/events

Successful response (200) schema
object

AuditEventsPage contains the results of listing audit events.

next_page_token string

Token for the next page in the listing operation. Set this value as `page_token` in the subsequent request. Empty on the last page.

items array of objects

List of audit events.

object

AuditEvent describes an audit event.

id string

Event ID.

actor_email string

Email address of the actor who triggered the event.

actor_name string

Name of the actor who triggered the event.

action string

Action performed by the actor.

subject string

Subject affected by the action.

created_at date-time

Timestamp when the event was created.

details string

Additional event information in JSON format. The exact structure depends on the audit event type and may change in future product versions.

Response example
{
  "next_page_token": "string",
  "items": [
    {
      "id": "string",
      "actor_email": "string",
      "actor_name": "string",
      "action": "string",
      "subject": "string",
      "created_at": "2025-11-19T20:02:49.314307Z",
      "details": "string"
    }
  ]
}