Documentation
DocsUsing withHumanAudit log

Audit event types

Understand the events recorded in the audit log and the details they contain.

Updated Sep 24, 2026

Use this reference when you open an event in the audit log and want to understand what it means. The names below match the Event column and the event page's title.

Every event identifies its actor, subject and time. The last column describes useful fields in data, which vary with the event and how the action happened. No additional data means you can use the actor, subject and timestamp to understand the event.

The Event types picker only lists events already recorded in your organization. You won't necessarily see every type below in your own log.

Requests and decisions

These events describe a request arriving or ending, and changes to who can review it.

EventMeaningUseful recorded details
approval.createdAn agent instance submitted an approval request.agent_instance_id, tool, deadline_at.
approval.decidedA human or an approval pipeline approved or denied the request.status; human decisions include note, channel and reviewer details. Automatic decisions identify source and the pipeline evaluation.
approval.expiredThe request reached its deadline without an approval or denial.No additional data.
approval.cancelledThe requesting agent instance withdrew the request.agent_instance_id, agent_instance_name.
request.reviewer_addedSomeone added another reviewer to the request.The added person's membership_id and added_by_membership_id.
decision.unroutedSomeone made a decision using permission to act outside the request's normal reviewer routing. Recorded alongside approval.decided.decision_id, reason, dangerous.

Approval pipeline evaluation

These events belong to the request being evaluated. The organization and agent stages are recorded as part of one evaluation. See Approval pipelines for how those stages fit together.

EventMeaningUseful recorded details
request_approval_pipeline.startedPipeline evaluation began for a request.agent_slug, block_count, and the organization and agent pipeline revisions.
request_approval_block.evaluatedA pipeline block finished checking the request. A branch records outcome enter when the request matched it and next when the request skipped it. If no block inside the branch decided, the branch records a second event with end_of_branch.block_name, block_type, scope, revision, outcome, reason, attempt_count, and any error or evaluation trace. end_of_branch is true on a branch's second event.
request_approval_pipeline.suspendedEvaluation paused before a block that continues asynchronously, such as an external check. It does not mean the pipeline was disabled.The suspended block's ID, key, type and scope, plus the number of blocks already attempted.
request_approval_pipeline.completedEvaluation finished with an approval, denial or need for human review.outcome, reason_code, the deciding block when there is one, pipeline revisions, attempt counts and duration_ms. reason_code is end_of_branch when no block in an entered branch decided; the branch is then the deciding block.

Review routing and escalation

These events describe how an escalation path handles human review, and when a reviewer claims or releases a request.

EventMeaningUseful recorded details
routing.evaluatedwithHuman selected the request's review route, or placed it in the default queue.outcome, reason, urgency, and the escalation path and pipeline identifiers when applicable.
routing.level_enteredThe path or a team's policy reached a reviewer stage. This records the selected targets, not confirmation that messages were delivered.targets, level_ordinal, level_count, urgency, repeat, and team_id for a team policy.
routing.deferredEscalation was deferred until a later time.until and the step's node_id; team_id when applicable.
routing.urgency_raisedThe path raised the request's notification urgency.from, to, node_id; team_id when applicable.
routing.repeatedThe path or team policy started another pass.iteration, after; team_id when applicable.
routing.escalation_exhaustedThe path or team policy had no further escalation steps. An unanswered request can still be pending.team_id for a team policy; otherwise no additional data.
routing.claimedA reviewer claimed the request, pausing escalation while the claim is active.claim_id, the reviewer's membership_id, expires_at.
routing.claim_releasedThe reviewer released their claim.claim_id, membership_id.
routing.claim_lapsedA claim expired automatically.claim_id.

Approval pipeline changes

These events record changes to pipeline configuration. Saving a revision and activating it are separate events.

EventMeaningUseful recorded details
request_approval_pipeline.revision_createdA pipeline revision was created.scope, agent_slug for an agent pipeline, revision, block_count.
request_approval_pipeline.activatedA pipeline revision became active.scope, agent_slug when applicable, revision, previous_active_revision.
request_approval_pipeline.archivedAn agent's pipeline was archived with the agent.agent_slug, scope, revision_count, active_revision.
request_approval_pipeline.restoredAn agent's archived pipeline was restored with the agent.agent_slug, scope, revision_count, active_revision.

Escalation path changes

EventMeaningUseful recorded details
escalation_path.createdA named escalation path was created with its first revision.path_key, revision.
escalation_path.revision_createdA new revision was saved for an existing path.path_key, revision.
escalation_path.activatedA path revision became active.path_key, revision, previous_active_revision.
escalation_path.archivedAn escalation path was archived.path_key, revision_count, active_revision.

Agents, instances and credentials

See Agents for the distinction between an agent and its instances.

EventMeaningUseful recorded details
agent.createdAn agent was created.agent_slug, name.
agent.renamedAn agent's display name changed.agent_slug, previous_name, name.
agent.disabledAn agent was disabled.agent_slug, previous_status, status.
agent.enabledAn agent was re-enabled.agent_slug, previous_status, status.
agent.archivedAn agent was archived, including its pipeline and credentials.agent_slug, name, previous_status, revoked credential and provisioner counts, and pipeline_archived.
agent.restoredAn archived agent was restored.agent_slug, name, pipeline_restored.
agent_instance.registeredA person registered an instance directly.agent_slug, the instance's name.
agent_instance.enrolledA person authorized an instance through the browser enrollment flow.agent_slug, agent_name, instance_name.
agent_instance.mintedA provisioner token created an instance.provisioner_id, the instance's name.
agent_instance.disabledAn individual instance was disabled.agent_slug, previous_status, status.
agent_instance.enabledAn individual instance was re-enabled.agent_slug, previous_status, status.
agent_provisioner.createdA provisioner token was issued for an agent.agent_slug, expires_at.
agent_provisioner.revokedA provisioner token was revoked.No additional data. The subject identifies the provisioner.
agent_credential.revokedAn instance's credential was revoked.No additional data. The subject identifies the credential.

Teams and team escalation policies

EventMeaningUseful recorded details
team.createdA team was created, either by a person or directory sync.name; directory-created teams also identify their admission_source.
team.renamedA team's name changed.before, after.
team.archivedA team was archived.The team's name, or admission_source when archived by directory sync.
team.members_changedA team's membership was edited.added and removed member IDs, and source.
team_escalation_policy.revision_createdA revision of a team's escalation policy was saved.team_id, revision.
team_escalation_policy.activatedA team escalation policy revision became active.team_id, revision, previous_active_revision.
team_escalation_policy.deactivatedA team's escalation policy was deactivated.team_id, revision; reason when caused by archiving the team.

Webhook endpoints

EventMeaningUseful recorded details
webhook_endpoint.revision_createdA webhook endpoint revision was saved, including the first revision of a new endpoint.endpoint_key, name, revision, url_host, secret_created.
webhook_endpoint.activatedA webhook endpoint revision became active.endpoint_key, revision, previous_active_revision, url_host.
webhook_endpoint.deactivatedAn active webhook endpoint was deactivated.endpoint_key, revision.
webhook_endpoint.secret_rotatedAn endpoint's signing secret was rotated.endpoint_key, name. The secret itself is not recorded.
webhook_endpoint.testedSomeone tested a webhook endpoint. The result may be a success or a failure.endpoint_key, revision, http_status, duration_ms, problem.

Gateway activity

EventMeaningUseful recorded details
agent.tool_access_changedAn agent’s access to a server’s tools changed.agent_slug, mcp_server, previous, and current grants, including their revisions.
gateway.tool_callThe gateway recorded the outcome of a tool call.tool, mcp_server, outcome, agent_instance_id, and approval_request_id for the request the pipeline decided the call on, and reason: access_denied when tool access blocked the call before a request was created.
gateway_server.createdAn upstream MCP server was added to the gateway.slug, name, revision, url, auth_mode.
gateway_server.revision_createdA new gateway server configuration revision was saved.slug, name, revision, url, auth_mode.
gateway_server.activatedA gateway server revision became active.slug, revision, previous_active_revision.
gateway_server.deactivatedA gateway server was deactivated.slug, revision.
gateway_server.archivedA gateway server was archived and its saved secrets were removed.slug, revision_count, active_revision, secrets_dropped.
gateway_server.secret_setA gateway server secret was saved or replaced.kind, identifying the kind of secret. The secret itself is not recorded.
gateway_server.secret_deletedA gateway server secret was removed.kind.

Tool presentations

EventMeaningUseful recorded details
tool_presentation.createdA presentation was created to control how a tool's requests are displayed.runtime, server, tool.
tool_presentation.updatedA tool presentation was changed.runtime, server, tool.
tool_presentation.deletedA tool presentation was removed.runtime, server, tool.

Invitations and membership

EventMeaningUseful recorded details
invitation.createdSomeone was invited to the organization.email, the invitation's permission grants.
invitation.resentAn invitation was renewed for resending.email.
invitation.revokedAn outstanding invitation was revoked.email.
invitation.acceptedSomeone accepted an invitation.email, user_id.
membership.createdA person joined the organization.admission_source and, depending on how they joined, their email or permission grants.
membership.suspendedA person's organization membership was suspended.previous_status, or directory details such as external_id and email.
membership.reactivatedA person's organization membership was made active again.previous_status.
membership.deprovisionedA person's organization membership was deprovisioned.previous_status, or directory details such as external_id and email.
membership.directory_syncedDirectory sync updated a person's membership to active.external_id, email.
membership.identity_linkedA verified sign-in identity was linked to a member.provider_key, issuer, email.
directory.command_rejectedA directory update could not be applied.reason, external_event_id.

Roles and permission policies

Permission policies describe a person's, team's or API key's access. Role and assignment events record changes to the roles and grants that provide that access.

EventMeaningUseful recorded details
permission_policy.createdA permission policy was added.principal_kind, principal_id, and the policy in after.
permission_policy.updatedA permission policy was changed.principal_kind, principal_id, before, after.
permission_policy.deletedA permission policy was removed.principal_kind, principal_id, and its recorded policy details in before and after.
role.createdA role was created.key, name, permissions, bindable_scope_kinds, dangerous.
role.updatedA role changed, including a System update to a built-in role.The role's name and key, before_permissions, after_permissions.
role.deletedA role was deleted.Its key, name and permissions at deletion.
role_assignment.grantedA principal received a role for a particular scope.principal_kind, principal_id, role_key, scope_kind, scope_id, source.
role_assignment.revokedA principal's role assignment was removed.principal_kind, principal_id, role_key, scope_kind, scope_id, source.

API keys

EventMeaningUseful recorded details
api_key.createdA personal or organization API key was created.kind, name, expires_at, and its permissions or permission policies.
api_key.revokedAn API key was revoked, directly or because its holder lost access.revocation_reason; automatic revocation can also identify the membership and key name.
api_key.usedAn organization API key was used for an API call.credential_id, the HTTP method and route.

Organization integrations

These events record connecting or removing an integration, rather than individual notifications.

EventMeaningUseful recorded details
slack_connection.createdA Slack workspace connection was installed or replaced.team_id, team_name, bot_user_id, scopes.
slack_connection.removedA Slack workspace connection was removed.team_id, team_name.
discord_connection.createdA Discord server connection was installed or replaced.guild_id, guild_name.
discord_connection.removedA Discord server connection was removed.guild_id, guild_name.

Organization settings and lifecycle

EventMeaningUseful recorded details
organization.activatedAn organization was first activated.The activating person's email and display_name, admission_source, and identity_provider when applicable.
organization.policy_updatedOrganization policy settings changed.before, after.
organization.suspendedAn organization was suspended.reason, previous_status.
organization.resumedA suspended organization became active again.reason, previous_status.
organization.deletion_scheduledAn organization was scheduled for deletion.reason, previous_status.
organization.deletion_canceledA scheduled organization deletion was cancelled.reason, previous_status.
onboarding.startedSomeone started an agent setup session.session_id.
onboarding.completedOrganization onboarding was marked complete.outcome, session_id when associated with a setup session.

To follow these events for one request, return to Request history.