# List audit log actions [API catalog](/reference/api/) · [Docker Hub overview](/reference/api/hub/latest/) · [Product manual](https://docs.docker.com/docker-hub/) · [OpenAPI specification](/reference/api/hub/latest.yaml) API version: 2-beta `GET /v2/auditlogs/{account}/actions` List audit log actions for a namespace to be used as a filter for querying audit log events. This operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes. ## Connection and access [API connection and authentication guidance](/reference/api/hub/latest/#authentication) Server: `https://hub.docker.com` Effective security: alternatives are OR; schemes within an alternative are AND. An empty array declares no HTTP authentication requirement. ```json [ { "bearerAuth": [] } ] ``` ## Example request Replace placeholders and provide the required credentials or request body. ```console curl \ --request GET \ --header "Authorization: Bearer ${TOKEN}" \ --header 'Accept: application/json' \ 'https://hub.docker.com/v2/auditlogs//actions' ``` ## Parameters ### account Location: path. Required: yes. Namespace to query audit log actions for. ```json { "description": "Namespace to query audit log actions for.", "in": "path", "name": "account", "pointer": "/paths/~1v2~1auditlogs~1{account}~1actions/get/parameters/0", "required": true, "schema": { "type": "string" } } ``` ## Request and responses ### Response 200 application/json A successful response. Schema: ```json { "$ref": "#/components/schemas/GetAuditActionsResponse" } ``` response: ```json { "actions": { "billing": { "actions": [ { "description": "Occurs when your organization’s billing plan is upgraded to a higher tier plan.", "label": "Plan Upgraded", "name": "plan.upgrade" }, { "description": "Occurs when your organization’s billing plan is downgraded to a lower tier plan.", "label": "Plan Downgraded", "name": "plan.downgrade" }, { "description": "Occurs when a seat is added to your organization’s billing plan.", "label": "Seat Added", "name": "plan.seat_add" }, { "description": "Occurs when a seat is removed from your organization’s billing plan.", "label": "Seat Removed", "name": "plan.seat_remove" }, { "description": "Occurs when there is a change in the recurring interval that your organization is charged.", "label": "Billing Cycle Changed", "name": "plan.cycle_change" }, { "description": "Occurs when a scheduled plan downgrade for your organization is canceled.", "label": "Plan Downgrade Canceled", "name": "plan.downgrade_cancel" }, { "description": "Occurs when a scheduled seat removal for an organization’s billing plan is canceled.", "label": "Seat Removal Canceled", "name": "plan.seat_removal_cancel" }, { "description": "Occurs when a user in your organization requests a plan upgrade.", "label": "Plan Upgrade Requested", "name": "plan.upgrade.request" }, { "description": "Occurs when a user in your organization requests a plan downgrade.", "label": "Plan Downgrade Requested", "name": "plan.downgrade.request" }, { "description": "Occurs when a user in your organization requests an increase in the number of seats.", "label": "Seat Addition Requested", "name": "plan.seat_add.request" }, { "description": "Occurs when a user in your organization requests a decrease in the number of seats.", "label": "Seat Removal Requested", "name": "plan.seat_removal.request" }, { "description": "Occurs when a user in your organization requests a change in the billing cycle.", "label": "Billing Cycle Change Requested", "name": "plan.cycle_change.request" }, { "description": "Occurs when a user in your organization requests a cancellation of a scheduled plan downgrade.", "label": "Plan Downgrade Cancellation Requested", "name": "plan.downgrade_cancel.request" }, { "description": "Occurs when a user in your organization requests a cancellation of a scheduled seat removal.", "label": "Seat Removal Cancellation Requested", "name": "plan.seat_removal_cancel.request" }, { "description": "Occurs when there is a change in the product that your organization subscribes to.", "label": "Billing Product Changed", "name": "plan.product_change" } ], "label": "Billing" }, "enterprise": { "actions": [ { "description": "Details of adding an admin settings policy", "label": "Policy created", "name": "setting.policy.create" }, { "description": "Details of updating an admin settings policy", "label": "Policy updated", "name": "setting.policy.update" }, { "description": "Details of deleting an admin settings policy", "label": "Policy deleted", "name": "setting.policy.delete" }, { "description": "Details of transferring an admin settings policy to another owner", "label": "Policy transferred", "name": "setting.policy.transfer" }, { "description": "Details of creating a new org/company SSO connection", "label": "Create SSO Connection", "name": "sso.connection.create" }, { "description": "Details of updating an existing org/company SSO connection", "label": "Update SSO Connection", "name": "sso.connection.update" }, { "description": "Details of deleting an existing org/company SSO connection", "label": "Delete SSO Connection", "name": "sso.connection.delete" }, { "description": "Details of toggling enforcement on an existing org/company SSO connection", "label": "Enforce SSO", "name": "sso.connection.enforcement_toggle" }, { "description": "Details of toggling SCIM on an existing org/company SSO connection", "label": "Enforce SCIM", "name": "sso.connection.scim_toggle" }, { "description": "Details of a SCIM token refresh on an existing org/company SSO connection", "label": "Refresh SCIM Token", "name": "sso.connection.scim_token_refresh" }, { "description": "Details of a connection type change on an existing org/company SSO connection", "label": "Change SSO Connection Type", "name": "sso.connection.connection_type_change" }, { "description": "Details of a JIT toggle on an existing org/company SSO connection", "label": "Toggle JIT provisioning", "name": "sso.connection.jit_toggle" } ], "label": "Enterprise" }, "offload": { "actions": [ { "description": "Details of the started Offload lease.", "label": "Offload lease start", "name": "lease.start" }, { "description": "Details of the ended Offload lease.", "label": "Offload lease end", "name": "lease.end" } ], "label": "Offload" }, "oidc": { "actions": [ { "description": "Details of creating an OIDC connection.", "label": "OIDC connection created", "name": "connection.create" }, { "description": "Details of updating an OIDC connection.", "label": "OIDC connection updated", "name": "connection.update" }, { "description": "Details of deleting an OIDC connection.", "label": "OIDC connection deleted", "name": "connection.delete" } ], "label": "OIDC" }, "org": { "actions": [ { "description": "Activities related to the creation of a new organization", "label": "Organization Created", "name": "create" }, { "description": "Details of the member added to your organization", "label": "Organization Member Added", "name": "member.add" }, { "description": "Details about the member removed from your organization", "label": "Organization Member Removed", "name": "member.remove" }, { "description": "Details about the role changed for a member in your organization", "label": "Member Role Changed", "name": "member.role.change" }, { "description": "Details of the member invited to your organization", "label": "Org Member Invited", "name": "member.invite.send" }, { "description": "Activities related to the creation of a team", "label": "Organization Created", "name": "team.create" }, { "description": "Activities related to the modification of a team", "label": "Organization Deleted", "name": "team.update" }, { "description": "Activities related to the deletion of a team", "label": "Organization Deleted", "name": "team.delete" }, { "description": "Details of the member added to your team", "label": "Team Member Added", "name": "team.member.add" }, { "description": "Details of the member removed from your team", "label": "Team Member Removed", "name": "team.member.remove" }, { "description": "Details of the single sign-on domain added to your organization", "label": "Single Sign-On domain added", "name": "domain.create" }, { "description": "Details of the single sign-on domain verified for your organization", "label": "Single Sign-On domain verified", "name": "domain.verify" }, { "description": "Details of the single sign-on domain removed from your organization", "label": "Single Sign-On domain deleted", "name": "domain.delete" }, { "description": "Details of toggling the Auto-Provisioning feature on a domain on or off", "label": "Organization Auto-Provisioning Toggled", "name": "domain.auto-provisioning.toggle" }, { "description": "Details related to the organization setting that was updated", "label": "Organization Settings Updated", "name": "settings.update" }, { "description": "Activities related to enabling Registry Access Management", "label": "Registry Access Management enabled", "name": "registry_access.enabled" }, { "description": "Activities related to disabling Registry Access Management", "label": "Registry Access Management disabled", "name": "registry_access.disabled" }, { "description": "Activities related to the addition of a registry", "label": "Registry Access Management registry added", "name": "registry_access.registry_added" }, { "description": "Details related to the registry that was updated", "label": "Registry Access Management registry updated", "name": "registry_access.registry_updated" }, { "description": "Activities related to the removal of a registry", "label": "Registry Access Management registry removed", "name": "registry_access.registry_removed" }, { "description": "Access token created in organization", "label": "Access token created", "name": "access_token.create" }, { "description": "Access token updated in organization", "label": "Access token updated", "name": "access_token.update" }, { "description": "Access token deleted in organization", "label": "Access token deleted", "name": "access_token.delete" }, { "description": "A custom role was created", "label": "Custom role created", "name": "customrole.create" }, { "description": "An existing custom role was updated", "label": "Custom role updated", "name": "customrole.update" }, { "description": "A custom role was deleted", "label": "Custom role deleted", "name": "customrole.delete" }, { "description": "A secure policy configuration was created", "label": "Secure Policy Configuration created", "name": "securepolicyconfigure.create" }, { "description": "A secure policy configuration was updated", "label": "Secure Policy Configuration updated", "name": "securepolicyconfigure.update" }, { "description": "A secure policy configuration was deleted", "label": "Secure Policy Configuration deleted", "name": "securepolicyconfigure.delete" }, { "description": "A secure policy client was created", "label": "Secure Policy Client created", "name": "securepolicyclient.create" }, { "description": "A secure policy client was updated", "label": "Secure Policy Client updated", "name": "securepolicyclient.update" }, { "description": "A secure policy client was deleted", "label": "Secure Policy Client deleted", "name": "securepolicyclient.delete" }, { "description": "A secure policy profile was created", "label": "Secure Policy Profile created", "name": "securepolicyprofile.create" }, { "description": "A secure policy profile was updated", "label": "Secure Policy Profile updated", "name": "securepolicyprofile.update" }, { "description": "A secure policy profile was deleted", "label": "Secure Policy Profile deleted", "name": "securepolicyprofile.delete" } ], "label": "Organization" }, "repo": { "actions": [ { "description": "Activities related to the creation of a new repository", "label": "Repository Created", "name": "create" }, { "description": "Activities related to the modification of a repository", "label": "Repository Updated", "name": "update" }, { "description": "Activities related to the deletion of a repository", "label": "Repository Deleted", "name": "delete" }, { "description": "Details related to the privacy policies that were updated", "label": "Privacy Changed", "name": "change_privacy" }, { "description": "Details related to updating a repository categories", "label": "Categories updated", "name": "category.updated" }, { "description": "Details related to updating tag immutability of a repository", "label": "Tag immutability updated", "name": "immutable.tags.updated" }, { "description": "Activities related to the tags pushed", "label": "Tag Pushed", "name": "tag.push" }, { "description": "Activities related to the tags deleted", "label": "Tag Deleted", "name": "tag.delete" } ], "label": "Repository" } } } ``` ### Response 429 application/json Schema: ```json {} ``` response: ```json { "detail": "Rate limit exceeded", "error": false } ``` ### Response 500 application/json Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "internal error" } ``` ### Response default application/json An unexpected error response. Schema: ```json { "$ref": "#/components/schemas/error" } ``` error: ```json { "errinfo": null, "message": "internal error" } ``` ## Complete operation contract ```json { "description": "List audit log actions for a namespace to be used as a filter for querying audit log events.\n\nThis operation accepts bearer tokens issued from organization access tokens (OATs). The token must have the required resource access and scopes.\n", "operationId": "AuditLogs_ListAuditActions", "parameters": [ { "description": "Namespace to query audit log actions for.", "in": "path", "name": "account", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "examples": { "response": { "value": { "actions": { "billing": { "actions": [ { "description": "Occurs when your organization’s billing plan is upgraded to a higher tier plan.", "label": "Plan Upgraded", "name": "plan.upgrade" }, { "description": "Occurs when your organization’s billing plan is downgraded to a lower tier plan.", "label": "Plan Downgraded", "name": "plan.downgrade" }, { "description": "Occurs when a seat is added to your organization’s billing plan.", "label": "Seat Added", "name": "plan.seat_add" }, { "description": "Occurs when a seat is removed from your organization’s billing plan.", "label": "Seat Removed", "name": "plan.seat_remove" }, { "description": "Occurs when there is a change in the recurring interval that your organization is charged.", "label": "Billing Cycle Changed", "name": "plan.cycle_change" }, { "description": "Occurs when a scheduled plan downgrade for your organization is canceled.", "label": "Plan Downgrade Canceled", "name": "plan.downgrade_cancel" }, { "description": "Occurs when a scheduled seat removal for an organization’s billing plan is canceled.", "label": "Seat Removal Canceled", "name": "plan.seat_removal_cancel" }, { "description": "Occurs when a user in your organization requests a plan upgrade.", "label": "Plan Upgrade Requested", "name": "plan.upgrade.request" }, { "description": "Occurs when a user in your organization requests a plan downgrade.", "label": "Plan Downgrade Requested", "name": "plan.downgrade.request" }, { "description": "Occurs when a user in your organization requests an increase in the number of seats.", "label": "Seat Addition Requested", "name": "plan.seat_add.request" }, { "description": "Occurs when a user in your organization requests a decrease in the number of seats.", "label": "Seat Removal Requested", "name": "plan.seat_removal.request" }, { "description": "Occurs when a user in your organization requests a change in the billing cycle.", "label": "Billing Cycle Change Requested", "name": "plan.cycle_change.request" }, { "description": "Occurs when a user in your organization requests a cancellation of a scheduled plan downgrade.", "label": "Plan Downgrade Cancellation Requested", "name": "plan.downgrade_cancel.request" }, { "description": "Occurs when a user in your organization requests a cancellation of a scheduled seat removal.", "label": "Seat Removal Cancellation Requested", "name": "plan.seat_removal_cancel.request" }, { "description": "Occurs when there is a change in the product that your organization subscribes to.", "label": "Billing Product Changed", "name": "plan.product_change" } ], "label": "Billing" }, "enterprise": { "actions": [ { "description": "Details of adding an admin settings policy", "label": "Policy created", "name": "setting.policy.create" }, { "description": "Details of updating an admin settings policy", "label": "Policy updated", "name": "setting.policy.update" }, { "description": "Details of deleting an admin settings policy", "label": "Policy deleted", "name": "setting.policy.delete" }, { "description": "Details of transferring an admin settings policy to another owner", "label": "Policy transferred", "name": "setting.policy.transfer" }, { "description": "Details of creating a new org/company SSO connection", "label": "Create SSO Connection", "name": "sso.connection.create" }, { "description": "Details of updating an existing org/company SSO connection", "label": "Update SSO Connection", "name": "sso.connection.update" }, { "description": "Details of deleting an existing org/company SSO connection", "label": "Delete SSO Connection", "name": "sso.connection.delete" }, { "description": "Details of toggling enforcement on an existing org/company SSO connection", "label": "Enforce SSO", "name": "sso.connection.enforcement_toggle" }, { "description": "Details of toggling SCIM on an existing org/company SSO connection", "label": "Enforce SCIM", "name": "sso.connection.scim_toggle" }, { "description": "Details of a SCIM token refresh on an existing org/company SSO connection", "label": "Refresh SCIM Token", "name": "sso.connection.scim_token_refresh" }, { "description": "Details of a connection type change on an existing org/company SSO connection", "label": "Change SSO Connection Type", "name": "sso.connection.connection_type_change" }, { "description": "Details of a JIT toggle on an existing org/company SSO connection", "label": "Toggle JIT provisioning", "name": "sso.connection.jit_toggle" } ], "label": "Enterprise" }, "offload": { "actions": [ { "description": "Details of the started Offload lease.", "label": "Offload lease start", "name": "lease.start" }, { "description": "Details of the ended Offload lease.", "label": "Offload lease end", "name": "lease.end" } ], "label": "Offload" }, "oidc": { "actions": [ { "description": "Details of creating an OIDC connection.", "label": "OIDC connection created", "name": "connection.create" }, { "description": "Details of updating an OIDC connection.", "label": "OIDC connection updated", "name": "connection.update" }, { "description": "Details of deleting an OIDC connection.", "label": "OIDC connection deleted", "name": "connection.delete" } ], "label": "OIDC" }, "org": { "actions": [ { "description": "Activities related to the creation of a new organization", "label": "Organization Created", "name": "create" }, { "description": "Details of the member added to your organization", "label": "Organization Member Added", "name": "member.add" }, { "description": "Details about the member removed from your organization", "label": "Organization Member Removed", "name": "member.remove" }, { "description": "Details about the role changed for a member in your organization", "label": "Member Role Changed", "name": "member.role.change" }, { "description": "Details of the member invited to your organization", "label": "Org Member Invited", "name": "member.invite.send" }, { "description": "Activities related to the creation of a team", "label": "Organization Created", "name": "team.create" }, { "description": "Activities related to the modification of a team", "label": "Organization Deleted", "name": "team.update" }, { "description": "Activities related to the deletion of a team", "label": "Organization Deleted", "name": "team.delete" }, { "description": "Details of the member added to your team", "label": "Team Member Added", "name": "team.member.add" }, { "description": "Details of the member removed from your team", "label": "Team Member Removed", "name": "team.member.remove" }, { "description": "Details of the single sign-on domain added to your organization", "label": "Single Sign-On domain added", "name": "domain.create" }, { "description": "Details of the single sign-on domain verified for your organization", "label": "Single Sign-On domain verified", "name": "domain.verify" }, { "description": "Details of the single sign-on domain removed from your organization", "label": "Single Sign-On domain deleted", "name": "domain.delete" }, { "description": "Details of toggling the Auto-Provisioning feature on a domain on or off", "label": "Organization Auto-Provisioning Toggled", "name": "domain.auto-provisioning.toggle" }, { "description": "Details related to the organization setting that was updated", "label": "Organization Settings Updated", "name": "settings.update" }, { "description": "Activities related to enabling Registry Access Management", "label": "Registry Access Management enabled", "name": "registry_access.enabled" }, { "description": "Activities related to disabling Registry Access Management", "label": "Registry Access Management disabled", "name": "registry_access.disabled" }, { "description": "Activities related to the addition of a registry", "label": "Registry Access Management registry added", "name": "registry_access.registry_added" }, { "description": "Details related to the registry that was updated", "label": "Registry Access Management registry updated", "name": "registry_access.registry_updated" }, { "description": "Activities related to the removal of a registry", "label": "Registry Access Management registry removed", "name": "registry_access.registry_removed" }, { "description": "Access token created in organization", "label": "Access token created", "name": "access_token.create" }, { "description": "Access token updated in organization", "label": "Access token updated", "name": "access_token.update" }, { "description": "Access token deleted in organization", "label": "Access token deleted", "name": "access_token.delete" }, { "description": "A custom role was created", "label": "Custom role created", "name": "customrole.create" }, { "description": "An existing custom role was updated", "label": "Custom role updated", "name": "customrole.update" }, { "description": "A custom role was deleted", "label": "Custom role deleted", "name": "customrole.delete" }, { "description": "A secure policy configuration was created", "label": "Secure Policy Configuration created", "name": "securepolicyconfigure.create" }, { "description": "A secure policy configuration was updated", "label": "Secure Policy Configuration updated", "name": "securepolicyconfigure.update" }, { "description": "A secure policy configuration was deleted", "label": "Secure Policy Configuration deleted", "name": "securepolicyconfigure.delete" }, { "description": "A secure policy client was created", "label": "Secure Policy Client created", "name": "securepolicyclient.create" }, { "description": "A secure policy client was updated", "label": "Secure Policy Client updated", "name": "securepolicyclient.update" }, { "description": "A secure policy client was deleted", "label": "Secure Policy Client deleted", "name": "securepolicyclient.delete" }, { "description": "A secure policy profile was created", "label": "Secure Policy Profile created", "name": "securepolicyprofile.create" }, { "description": "A secure policy profile was updated", "label": "Secure Policy Profile updated", "name": "securepolicyprofile.update" }, { "description": "A secure policy profile was deleted", "label": "Secure Policy Profile deleted", "name": "securepolicyprofile.delete" } ], "label": "Organization" }, "repo": { "actions": [ { "description": "Activities related to the creation of a new repository", "label": "Repository Created", "name": "create" }, { "description": "Activities related to the modification of a repository", "label": "Repository Updated", "name": "update" }, { "description": "Activities related to the deletion of a repository", "label": "Repository Deleted", "name": "delete" }, { "description": "Details related to the privacy policies that were updated", "label": "Privacy Changed", "name": "change_privacy" }, { "description": "Details related to updating a repository categories", "label": "Categories updated", "name": "category.updated" }, { "description": "Details related to updating tag immutability of a repository", "label": "Tag immutability updated", "name": "immutable.tags.updated" }, { "description": "Activities related to the tags pushed", "label": "Tag Pushed", "name": "tag.push" }, { "description": "Activities related to the tags deleted", "label": "Tag Deleted", "name": "tag.delete" } ], "label": "Repository" } } } } }, "schema": { "$ref": "#/components/schemas/GetAuditActionsResponse" } } }, "description": "A successful response." }, "429": { "content": { "application/json": { "examples": { "response": { "value": { "detail": "Rate limit exceeded", "error": false } } }, "schema": {} } }, "description": "" }, "500": { "content": { "application/json": { "examples": { "error": { "summary": "Example error response", "value": { "errinfo": null, "message": "internal error" } } }, "schema": { "$ref": "#/components/schemas/error" } } }, "description": "" }, "default": { "content": { "application/json": { "examples": { "error": { "summary": "Example error response", "value": { "errinfo": null, "message": "internal error" } } }, "schema": { "$ref": "#/components/schemas/error" } } }, "description": "An unexpected error response." } }, "security": [ { "bearerAuth": [] } ], "summary": "List audit log actions", "tags": [ "audit-logs" ] } ``` ## Referenced schemas - [#/components/schemas/GetAuditActionsResponse](/reference/api/hub/latest/schemas/GetAuditActionsResponse/) - [#/components/schemas/error](/reference/api/hub/latest/schemas/error/)