Modal logo

Audit Logs

Audit logs give your workspace an append-only record of the sensitive actions that change its state — who did what, when, to which resource, and from where. They are designed for compliance reviews, incident investigation, and answering questions like “did anyone delete this Secret last Thursday?” without asking Modal support.

Audit logs are viewable within the settings page.

Fields 

Every audit event captures the same shape alongside the time it occurred:

FieldWhat it is
actionThe kind of change that happened — e.g. secret.create, app.deploy. See the full list below.
actorThe user or service user that initiated the action.
targetsThe resource(s) the action affected, each recorded by ID so the event stays attributable after a rename or delete.
context.environmentThe environment the action was scoped to.
context.ip_addressThe client IP address.
context.sourceweb for the dashboard, sdk for the Modal CLI and client libraries.
statusWhether the action succeeded or failed.
metadataAction-specific extra fields — e.g. the old and new budget values for workspace.set_budget, or the requested region for a Proxy.

Filtering 

Audit events may be queried using the search syntax with the following keys:

KeyMatches
actionOne of the actions below, e.g. secret.create.
actor_emailThe email of the user.
actor_nameThe name of the user or service user.
actor_typeuser, service_user, or oauth_grant.
environmentThe environment name.
ip_addressThe client IP address.
sourceweb or sdk.
statussuccess or error.

For example:

FilterMatches
action:secret.createEvery Secret created in the selected time range.
-status:successAll actions that did not succeed.
action:volume.delete -actor_type:service_userVolume deletions by non-service users.

Actions 

The table below lists every action currently recorded. New actions will be added as additional workspace operations are instrumented.

Note: container runtime activity is not audited. Audit logs record workspace-level actions (deploying an App, creating a Volume, revoking a token) — not individual Function invocations or Sandbox exec calls, which are captured in Function and Sandbox logs.


ActionDescriptionAvailable Since
access_grant.approveA workspace manager approved a pending Modal-admin access grant.May 18, 2026
access_grant.revokeA workspace manager revoked an active Modal-admin access grant.May 18, 2026
app.deployAn App was deployed to the workspace (via modal deploy or implicitly via App.lookup).Mar 31, 2026
app.expose_unauthenticated_urlAn App’s Function or Server was given an unauthenticated public URL. The function id and name are recorded in the event metadata.Sep 11, 2026
app.promoteAn App was promoted from a staged version.Aug 19, 2026
app.rollbackAn App was rolled back to an earlier deployed version.Apr 28, 2026
app.rolloverAn App was rolled over — its current version was redeployed, restarting running tasks.Apr 28, 2026
app.runAn ephemeral App was started with modal run or modal serve.Apr 21, 2026
app.stopAn App was stopped from the dashboard or with modal app stop.Mar 27, 2026
container.stopA running container (task) was terminated from the dashboard or CLI. Routine container exits at the end of a call are not audited.Mar 27, 2026
dict.createA Dict was created.Apr 20, 2026
dict.getAn existing Dict was looked up by name or by ID.Apr 20, 2026
domain.createA custom domain was attached to an environment.Mar 27, 2026
domain.deleteA custom domain was removed.Mar 27, 2026
endpoint.candidate_deleteA candidate deployment was deleted from an Endpoint, and its backing App was stopped. The endpoint name and deployment ID are recorded in the event metadata.Oct 29, 2026
endpoint.create_unauthenticatedAn Endpoint was created without Modal Proxy Auth. The endpoint name is recorded in the event metadata.Sep 11, 2026
endpoint.stopAn Endpoint was stopped, along with its backing Apps. The endpoint name is recorded in the event metadata.Oct 29, 2026
environment.createA new environment was created in the workspace.Mar 27, 2026
environment.deleteAn environment was deleted.Mar 27, 2026
environment.getAn environment was looked up by name.Apr 20, 2026
environment.set_budgetAn environment’s spend budget was updated or cleared. The previous and new per-cycle budget values, effective maximum budget, and whether the budget changed are recorded in event metadata.Jun 20, 2026
environment.set_default_member_roleAn environment’s default member role was updated. It applies to workspace members without an explicit environment role; the previous and new defaults are recorded in event metadata.Aug 10, 2026
environment.set_managedAn environment was toggled between managed and unmanaged. Disabling managed access removes every per-environment role for that environment; whether it’s now managed is recorded in the event metadata.Jul 21, 2026
environment.updateAn environment’s settings changed — name, web suffix, per-environment concurrency limits, or whether unauthenticated resources are blocked. Before/after values are recorded in the event metadata.Mar 27, 2026
environment.update_groupA user group’s per-environment role (Contributor / Viewer / No Access) was changed, or the group’s environment-level access was removed.Aug 10, 2026
environment.update_memberA user or service user’s per-environment role (Contributor / Viewer / No Access) was changed, or their environment-level access was removed. Independent of their workspace-level role.Apr 28, 2026
function.update_body_collectionA Server or Dedicated Endpoint’s body collection or data retention settings were updated.Nov 19, 2026
image.deleteAn Image was deleted.Mar 27, 2026
integration.set_telemetry_signalsThe telemetry signals forwarded to a customer integration were changed.Sep 24, 2026
invite.create_for_workspaceA workspace-wide invite link was generated by a workspace admin.Mar 27, 2026
member.deleteA member was removed from the workspace.Apr 28, 2026
member.set_roleA workspace member’s workspace-wide role (Owner / Manager / User) was changed. The affected member(s) appear in the event targets and the new role(s) are recorded in the event metadata. Per-environment access is set separately via environment.update_member.Apr 28, 2026
nfs.createA NetworkFileSystem was created.Apr 27, 2026
nfs.getAn existing NetworkFileSystem was looked up by name.Apr 27, 2026
oauth_grant.approveA user authorized a third-party OAuth client to act on the workspace with their access. The client and the granted scopes are recorded in the event metadata.Sep 17, 2026
oauth_grant.revokeAn OAuth authorization was revoked, ending the client’s access on behalf of that user.Sep 17, 2026
proxy.add_ipA static egress IP was added to a Proxy.Mar 30, 2026
proxy.createA Proxy was created. The requested name and region are recorded in the event metadata.Mar 30, 2026
proxy.deleteA Proxy was deleted.Mar 30, 2026
proxy_token.add_environmentAn environment was added to a Proxy Auth token’s allowed environments. The environment name is recorded in the event metadata.Sep 4, 2026
proxy_token.createA Proxy Auth token was created. Whether the token is scoped to specific environments is recorded in the event metadata.Sep 4, 2026
proxy_token.deleteA Proxy Auth token was deleted.Sep 4, 2026
proxy_token.remove_environmentAn environment was removed from a Proxy Auth token’s allowed environments.Sep 4, 2026
proxy_token.updateA Proxy Auth token was updated. Previous and new field values are recorded in the event metadata.Sep 24, 2026
queue.deleteA Queue was deleted.Mar 27, 2026
queue.getAn existing Queue was looked up by ID.May 6, 2026
sandbox.createA Sandbox was launched.Apr 20, 2026
sandbox.terminateA Sandbox was explicitly terminated before its natural exit.Apr 20, 2026
secret.createA Secret was created or its values were overwritten (via modal secret create or the dashboard).Apr 20, 2026
secret.deleteA Secret was deleted.Sep 25, 2026
secret.getA named Secret was resolved to an ID (e.g. at deploy, or when opening a secret in the dashboard). Values are not returned; only the Secret’s ID and metadata are.Apr 20, 2026
secret.updateIndividual keys of an existing Secret were added, changed, or removed (via the dashboard). The added, updated, and removed key names are recorded in the event metadata; values are never recorded.Sep 28, 2026
service_user.createA service user was created together with its API token. The service user’s name and the id of the token issued to it are recorded in the event metadata.Sep 9, 2026
service_user.deleteA service user was deleted, revoking its API token and every environment role granted to it. The revoked token’s id is recorded in the event metadata.Sep 9, 2026
token.createAn API token was created. The token’s name and expiration are recorded in the event metadata.Sep 9, 2026
token.deleteAn API token was revoked.Mar 27, 2026
user.createA new user account was created.Apr 27, 2026
user_group.createA user group was created in the workspace.Aug 25, 2026
user_group.deleteA user group was deleted from the workspace.Sep 23, 2026
user_group.updateA user group’s name, membership, or environment roles were updated.Sep 10, 2026
volume.createA Volume was created.Apr 20, 2026
volume.deleteA Volume was deleted.Mar 27, 2026
volume.getAn existing Volume was looked up by name or by ID.Apr 20, 2026
volume.renameA Volume was renamed.Mar 30, 2026
workspace.createA new workspace was created.Mar 26, 2026
workspace.downgradeA workspace was downgraded to a lower billing plan.Jun 25, 2026
workspace.joinA user joined a workspace (by accepting an invite or self-serve signup).Mar 26, 2026
workspace.leaveA user left a workspace.Mar 26, 2026
workspace.renameA workspace was renamed. The previous and new workspace names are recorded in the event metadata. Renaming changes the workspace’s dashboard URLs. Deployed web endpoints keep their existing URLs until they are redeployed.Jun 25, 2026
workspace.set_budgetA workspace’s spend budget was updated. The previous and new per-cycle budget values are recorded in the event metadata.Mar 27, 2026
workspace.set_default_environment_settingsA workspace’s default environment settings were updated. Environments without an explicit override inherit these defaults. Before/after values for blocked unauthenticated resources are recorded in the event metadata.Sep 16, 2026
workspace.set_max_member_token_lifetimeA workspace’s maximum member API token lifetime was updated. Before/after values in seconds are recorded in the event metadata; an unset value means no cap.Sep 23, 2026
workspace.set_net_spend_limitA workspace’s out-of-pocket (net) spend limit was updated. The previous and new per-cycle limits are recorded in the event metadata.Aug 15, 2026
workspace.update_github_autojoinWhether members of the linked GitHub organization can join the workspace without an invite was changed.Jul 22, 2026
workspace.update_idpA workspace’s SAML identity provider configuration was changed. Enabling SSO enforcement immediately logs out sessions not authenticated through SAML.Jul 21, 2026
workspace.upload_idp_metadataA SAML metadata document was uploaded for a workspace, replacing any file Modal already hosted for it. This sets the workspace’s SSO metadata URL and the identity provider whose sign-ins Modal will accept.Sep 17, 2026