List audit events
Events recorded in the token’s organization about projects, environments, components, variables, pipelines, clusters and integrations, newest first. Without a target filter it requires audit:read on the organization and returns every event, including denials and their origin. With target_type project or environment and a target_id, the read Permission on that resource is enough: the events about it and everything it contains are returned, without denials or origin. The Auth API serves the organization’s own events (members, Roles, OAuth applications, sign-ins) with the same schema and filters.
/audit-eventsAuthorizationBearer token (JWT) · headerrequiredJWT token passed in the Authorization header using the Bearer <token> format.
actionstring[]Only events with one of these actions.
actor_idstringOnly events by this user or client, or that the system recorded on their behalf (metadata.initiated_by).
target_typestringWith target_id, only events about this object, as their primary target or an ancestor of it.
target_idstring<uuid>affected_user_idstring<uuid>outcomestringalloweddeniedchanged_fieldstringOnly events that changed this field.
sincestring<date-time>Only events at or after this time.
untilstring<date-time>Only events before this time.
cursorstringThe next_cursor of the previous page.
limitintegerA page of events.
eventsaudit_event[]requiredNewest first.
Show propertiesHide properties
audit_eventidstring<uuid>requiredUUIDv7, unique within its source.
sourcestringrequiredauthengineorganization_idstring<uuid> | nullNull for events before an organization is known, such as a failed sign-in.
occurred_atstring<date-time>requiredTransaction time of the change, from the source's database clock.
actionstringrequiredDotted name from the source's closed catalog, such as member.roles_updated or environment.deleted.
actoraudit_actorrequiredWho acted, as they were when they did.
Show propertiesHide properties
typestringrequireduserclientsystemidstringrequiredThe user or client UUID, system, or unknown for someone who did not prove who they are.
emailstring | nullnamestring | nulltargetsaudit_target[]requiredThe objects the event acted on (primary) and the objects containing them (ancestor), as named then.
Show propertiesHide properties
audit_targettypestringrequiredA Resource Type, such as role, project, environment or kapplication.
idstring<uuid>requirednamestring | nullThe object's name when the event happened, if known.
relationstringrequiredprimaryancestoraffected_useraudit_person | nullThe person acted upon, when it is not the actor; id is null for an invitee without an account.
Show propertiesHide properties
idstring<uuid> | nullemailstring | nullnamestring | nulloutcomestringrequiredalloweddenieddenial_reasonstring | nullWhy a denied action was refused, such as the missing Permission.
changed_fieldsstring[]requiredchangesaudit_changes | nullValues of the changed fields before and after; a field holding a secret is in changed_fields but never here.
Show propertiesHide properties
beforeobject | nullafterobject | nullmetadataobjectrequiredSmall action-specific details. Two keys are reserved for what the system records on behalf of someone, when work they started finishes later: initiated_by, the actor who started it (type, id, and email or name when known), and caused_by, the id of the event that started it. A refusal that stands for repeats of itself carries repeats, how many identical refusals were dropped since the previous one recorded.
originaudit_originrequiredWhere the request came from. Omitted fields are not shown to resource readers.
Show propertiesHide properties
ipstring | nulluser_agentstring | nullentry_pointstringrequiredhttpwebinternalrequest_idstring | nullnext_cursorstring | nullPass as cursor for the next, older page; null on the last page.
Error
codeinteger<int32>requiredmessagestringrequiredreasonstringOptional stable machine-readable reason for programmatic error handling