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:
| Field | What it is |
|---|---|
action | The kind of change that happened — e.g. secret.create, app.deploy. See the full list below. |
actor | The user or service user that initiated the action. |
targets | The resource(s) the action affected, each recorded by ID so the event stays attributable after a rename or delete. |
context.environment | The environment the action was scoped to. |
context.ip_address | The client IP address. |
context.source | web for the dashboard, sdk for the Modal CLI and client libraries. |
status | Whether the action succeeded or failed. |
metadata | Action-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:
| Key | Matches |
|---|---|
action | One of the actions below, e.g. secret.create. |
actor_email | The email of the user. |
actor_name | The name of the user or service user. |
actor_type | user, service_user, or oauth_grant. |
environment | The environment name. |
ip_address | The client IP address. |
source | web or sdk. |
status | success or error. |
For example:
| Filter | Matches |
|---|---|
action:secret.create | Every Secret created in the selected time range. |
-status:success | All actions that did not succeed. |
action:volume.delete -actor_type:service_user | Volume 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
execcalls, which are captured in Function and Sandbox logs.
| Action | Description | Available Since |
|---|---|---|
access_grant. | A workspace manager approved a pending Modal-admin access grant. | May 18, 2026 |
access_grant. | A workspace manager revoked an active Modal-admin access grant. | May 18, 2026 |
app. | An App was deployed to the workspace (via modal deploy or implicitly via App.lookup). | Mar 31, 2026 |
app. | An 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. | An App was promoted from a staged version. | Aug 19, 2026 |
app. | An App was rolled back to an earlier deployed version. | Apr 28, 2026 |
app. | An App was rolled over — its current version was redeployed, restarting running tasks. | Apr 28, 2026 |
app. | An ephemeral App was started with modal run or modal serve. | Apr 21, 2026 |
app. | An App was stopped from the dashboard or with modal app stop. | Mar 27, 2026 |
container. | A 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. | A Dict was created. | Apr 20, 2026 |
dict. | An existing Dict was looked up by name or by ID. | Apr 20, 2026 |
domain. | A custom domain was attached to an environment. | Mar 27, 2026 |
domain. | A custom domain was removed. | Mar 27, 2026 |
endpoint. | A 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. | An Endpoint was created without Modal Proxy Auth. The endpoint name is recorded in the event metadata. | Sep 11, 2026 |
endpoint. | An Endpoint was stopped, along with its backing Apps. The endpoint name is recorded in the event metadata. | Oct 29, 2026 |
environment. | A new environment was created in the workspace. | Mar 27, 2026 |
environment. | An environment was deleted. | Mar 27, 2026 |
environment. | An environment was looked up by name. | Apr 20, 2026 |
environment. | An 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. | An 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. | An 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. | An 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. | A 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. | A 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. | A Server or Dedicated Endpoint’s body collection or data retention settings were updated. | Nov 19, 2026 |
image. | An Image was deleted. | Mar 27, 2026 |
integration. | The telemetry signals forwarded to a customer integration were changed. | Sep 24, 2026 |
invite. | A workspace-wide invite link was generated by a workspace admin. | Mar 27, 2026 |
member. | A member was removed from the workspace. | Apr 28, 2026 |
member. | A 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. | A NetworkFileSystem was created. | Apr 27, 2026 |
nfs. | An existing NetworkFileSystem was looked up by name. | Apr 27, 2026 |
oauth_grant. | A 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. | An OAuth authorization was revoked, ending the client’s access on behalf of that user. | Sep 17, 2026 |
proxy. | A static egress IP was added to a Proxy. | Mar 30, 2026 |
proxy. | A Proxy was created. The requested name and region are recorded in the event metadata. | Mar 30, 2026 |
proxy. | A Proxy was deleted. | Mar 30, 2026 |
proxy_token. | An 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. | A Proxy Auth token was created. Whether the token is scoped to specific environments is recorded in the event metadata. | Sep 4, 2026 |
proxy_token. | A Proxy Auth token was deleted. | Sep 4, 2026 |
proxy_token. | An environment was removed from a Proxy Auth token’s allowed environments. | Sep 4, 2026 |
proxy_token. | A Proxy Auth token was updated. Previous and new field values are recorded in the event metadata. | Sep 24, 2026 |
queue. | A Queue was deleted. | Mar 27, 2026 |
queue. | An existing Queue was looked up by ID. | May 6, 2026 |
sandbox. | A Sandbox was launched. | Apr 20, 2026 |
sandbox. | A Sandbox was explicitly terminated before its natural exit. | Apr 20, 2026 |
secret. | A Secret was created or its values were overwritten (via modal secret create or the dashboard). | Apr 20, 2026 |
secret. | A Secret was deleted. | Sep 25, 2026 |
secret. | A 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. | Individual 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. | A 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. | A 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. | An API token was created. The token’s name and expiration are recorded in the event metadata. | Sep 9, 2026 |
token. | An API token was revoked. | Mar 27, 2026 |
user. | A new user account was created. | Apr 27, 2026 |
user_group. | A user group was created in the workspace. | Aug 25, 2026 |
user_group. | A user group was deleted from the workspace. | Sep 23, 2026 |
user_group. | A user group’s name, membership, or environment roles were updated. | Sep 10, 2026 |
volume. | A Volume was created. | Apr 20, 2026 |
volume. | A Volume was deleted. | Mar 27, 2026 |
volume. | An existing Volume was looked up by name or by ID. | Apr 20, 2026 |
volume. | A Volume was renamed. | Mar 30, 2026 |
workspace. | A new workspace was created. | Mar 26, 2026 |
workspace. | A workspace was downgraded to a lower billing plan. | Jun 25, 2026 |
workspace. | A user joined a workspace (by accepting an invite or self-serve signup). | Mar 26, 2026 |
workspace. | A user left a workspace. | Mar 26, 2026 |
workspace. | A 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. | A workspace’s spend budget was updated. The previous and new per-cycle budget values are recorded in the event metadata. | Mar 27, 2026 |
workspace. | A 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. | A 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. | A 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. | Whether members of the linked GitHub organization can join the workspace without an invite was changed. | Jul 22, 2026 |
workspace. | A workspace’s SAML identity provider configuration was changed. Enabling SSO enforcement immediately logs out sessions not authenticated through SAML. | Jul 21, 2026 |
workspace. | A 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 |