List audit events
Requires audit:read. Events about Roles, memberships, invitations, OAuth applications, single sign-on and sign-ins, newest first, including denials and their origin. The Platform API serves the events about projects, environments, components and clusters with the same schema and filters.
/organizations/{organizationId}/audit-eventsAuthorizationBearer token (JWT) · headerrequiredAn access token issued by this service (RFC 9068), in the Authorization header as Bearer <token>.
organizationIdstring<uuid>requiredactionstring[]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.
The request failed.
errorstringrequiredStable machine-readable code.
invalid_requestunauthorizedforbiddennot_foundconflictgoneunavailableinternalmessagestringrequiredHuman-readable explanation.