# Activity Data Reference

This page contains the details of each table: the schema, and a reference to understand the contents. Use this bookmarks to quickly find the specific table details you're looking for:

* [Activity Logs](#activity-logs)
* [API Usage](#api-usage)
* [User List](#user-list)
* [Group List](#group-list)

## Activity Logs

A complete collection of logs for every event that happened in your CARTO organization

### Schema

| Column | Type          | Description                                                                                                                  |
| ------ | ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `type` | `STRING`      | Identifies the specific event that occurred. Check the event reference for a list of possible values. Example: `MapCreated`. |
| `ts`   | `TIMESTAMP`   | The timestamp of the event, in UTC.                                                                                          |
| `data` | `JSON STRING` | The payload with all the data associated with the event. Check the event reference for a list of possible values.            |

### Event Reference

<table><thead><tr><th width="251.96875">type</th><th>Description</th><th>Data</th></tr></thead><tbody><tr><td>AccountBrandingDeleted</td><td><a href="../../customizations/customizing-appearance-and-branding#appearance">Custom branding</a> was reset to CARTO defaults</td><td>Contains the admin that produced the action</td></tr><tr><td>AccountBrandingUpdated</td><td><a href="../../customizations/customizing-appearance-and-branding#appearance">Custom branding</a> was modified</td><td>Contains the admin that modified the branding</td></tr><tr><td>AccountCreated</td><td>Your organization was created</td><td>Contains info about the industry customization, if any</td></tr><tr><td>AccountDeleted</td><td>Your organization was deleted</td><td></td></tr><tr><td>AccountDeletedUI</td><td>Your organization was deleted using <a href="../deleting-your-organization">the button in CARTO Workspace</a></td><td>Contains infomation about the user who triggered the deletion</td></tr><tr><td>AccountRestored</td><td>Your organization was no longer suspended and can be accessed</td><td></td></tr><tr><td>AccountSuspended</td><td>Your organization was suspended and can't be accessed</td><td></td></tr><tr><td>AccountUpdated</td><td>Your organization was updated, typically metadata</td><td></td></tr><tr><td>ActivityDataExportRequest</td><td>Someone in your organization requested a <a href="">Activity Data</a> export</td><td>Contains info about the date ranges and the categories requested, as well as the user who requested it</td></tr><tr><td>AIAgentConfigurationChanged</td><td>The configuration of an <a href="../../ai-agents">AI Agent</a> was modified </td><td>Contains info about the map, query sources setting, tools, and the model</td></tr><tr><td>AIAgentConversationDeleted</td><td>A conversation with an <a href="../../ai-agents">AI Agent</a> was deleted</td><td>Contains the map, conversation, mode (testing/live)</td></tr><tr><td>AIAgentConversationStarted</td><td>A new conversation was started with an <a href="../../ai-agents">AI Agent</a> </td><td>Contains the map, conversation, mode (testing/live), and the model</td></tr><tr><td>AIAgentCreated</td><td>An <a href="../../ai-agents">AI Agent</a> was created for a Builder map</td><td>Contains info about the map</td></tr><tr><td>AIAgentDeleted</td><td>An <a href="../../ai-agents">AI Agent</a> was deleted from a Builder map</td><td>Contains info about the map</td></tr><tr><td>AIAgentError</td><td>An error occurred during <a href="../../ai-agents">AI Agent</a> interaction</td><td>Contains info about the map, conversation, response, and error message</td></tr><tr><td>AIAgentFeedback</td><td>Someone gave feedback (positive or negative) to the  <a href="../../ai-agents">AI Agent</a> </td><td>Contains info about the map, conversation mode, and feedback type</td></tr><tr><td>AIAgentRequest</td><td>A request was made to the <a href="../../ai-agents">AI Agent</a> </td><td>Contains info about the map, conversation, model, mode, and account</td></tr><tr><td>AIAgentResponse</td><td>The <a href="../../ai-agents">AI Agent</a> generated a response</td><td>Contains info about the map, conversation, and response</td></tr><tr><td>AIAgentResponseStopped</td><td>A user stopped an <a href="../../ai-agents">AI Agent</a> response mid-generation</td><td>Contains info about the map, conversation, and mode</td></tr><tr><td>AIAgentsListed</td><td>A user listed <a href="../../ai-agents">AI Agents</a> in the workspace</td><td>Contains info about the user</td></tr><tr><td>AIAgentToolExecuted</td><td>An <a href="../../ai-agents">AI Agent</a> tool finished execution</td><td>Contains info about the map, conversation, tool name, success status, and error if failed</td></tr><tr><td>AIAgentToolInvoked</td><td>An <a href="../../ai-agents">AI Agent</a> invoked a tool during a conversation</td><td>Contains info about the map, conversation, and response</td></tr><tr><td>AIConsumed</td><td><a href="../carto-ai">AI</a> tokens were consumed for a request</td><td>Contains info about the user, model, tokens consumed, and AI feature</td></tr><tr><td>AIRequestGotOverquota</td><td>An AI request was blocked because the account exceeded its AI token quota when using <a href="../carto-ai">CARTO Managed Models</a></td><td>Contains info about the user, AI feature, and timestamp</td></tr><tr><td>AppCreated</td><td>An <a href="../../developers/managing-credentials">OAuth client</a> was created</td><td>Contains info about the user that created it, and the type + ID of OAuth Client</td></tr><tr><td>AppDeleted</td><td>An <a href="../../developers/managing-credentials">OAuth client</a> was deleted</td><td>Contains info about the user who deleted it, as well as which OAuth Client was deleted</td></tr><tr><td>AppGallerySelected</td><td>A user opened one of the applications in the <a href="../../../applications#featured-applications">App Gallery</a></td><td>Contains info about which user opened which application</td></tr><tr><td>AppOwnershipTransferred</td><td>Ownership of an app was transferred to another user</td><td>Contains info about the app, previous owner, new owner, and app type</td></tr><tr><td>AppPrivacyChanged</td><td>The privacy settings of an <a href="../../applications">app</a> were changed</td><td>Contains info about the app, original privacy, and new privacy</td></tr><tr><td>AppSelected</td><td>A user opened one of the <a href="../../applications">applications</a> bookmarked by your admins in <a href="../../applications">Applications</a></td><td>Contains info about which user and which application</td></tr><tr><td>AppUpdated</td><td>An admin updated one of the <a href="../advanced-settings/managing-registered-apps">applications</a> in the organization</td><td>Contains info about which admin and which application, and whether the app is bookmarked at the homepage</td></tr><tr><td>ATInstallationFinished</td><td>A UI-assisted installation of the <a href="../../../faqs/analytics-toolbox">Analytics Toolbox</a> was completed</td><td>Contains info about the provider and the AT version</td></tr><tr><td>ATInstallationStarted</td><td>A UI-assisted installation of the <a href="../../../faqs/analytics-toolbox">Analytics Toolbox </a>was completed</td><td>Contains info about the provider and the AT version</td></tr><tr><td>ATUninstallFinished</td><td>A UI-assisted un-installation of the <a href="../../../faqs/analytics-toolbox">Analytics Toolbox </a>was completed</td><td>Contains info about the provider</td></tr><tr><td>ATUninstallStarted</td><td>A UI-assisted un-installation of the <a href="../../../faqs/analytics-toolbox">Analytics Toolbox </a>was completed</td><td>Contains info about the provider</td></tr><tr><td>BigQueryLocationUsage</td><td>A resource from a <a href="../../connections/bigquery">BigQuery connection </a>was used</td><td>Contains info about the location</td></tr><tr><td>BucketIntegrationCreated</td><td>An <a href="../advanced-settings">integration</a> of a storage bucket was completed</td><td>Contains info about the provider and the admin who completed the integration</td></tr><tr><td>BucketIntegrationDeleted</td><td>An <a href="../advanced-settings">integration</a> of a storage bucket was deleted</td><td>Contains info about the provider and the admin who deleted the integration</td></tr><tr><td>BucketIntegrationUpdated</td><td>An <a href="../advanced-settings">integration</a> of a storage bucket was updated</td><td>Contains info about the provider and the admin who updated the integration</td></tr><tr><td>BucketIntegrationVerificationFailed</td><td>CARTO tried to validate the <a href="../advanced-settings">integration</a> of a storage bucket, but it failed</td><td>Contains info about the provider, the admin who tried to validate, and the specific error</td></tr><tr><td>BuilderCommentCreated</td><td>A new <a href="../../maps/sharing-and-collaboration/comments">comment</a> was created on a Builder map</td><td>Contains info about the comment such as commentId, mapId, authorId, anchor, etc.</td></tr><tr><td>BuilderCommentDeleted</td><td>An existing <a href="../../maps/sharing-and-collaboration/comments">comment</a> was deleted.</td><td>Contains the commentId, authorId, mapId, and its anchor position (latitude, longitude, zoom) along with user and account identifiers.</td></tr><tr><td>BuilderCommentEdited</td><td>A <a href="../../maps/sharing-and-collaboration/comments">comment</a>'s content was updated</td><td>Contains info about the comment such as commentId, mapId, authorId, anchor, etc.</td></tr><tr><td>BuilderCommentReplyCreated</td><td>A reply was created in a <a href="../../maps/sharing-and-collaboration/comments">comment</a> thread</td><td>Includes the new reply's contentLength, hyperlinksCount, any mentions, and anchor data. Also contains user, author, and comment identifiers.</td></tr><tr><td>BuilderCommentReplyDeleted</td><td>A reply to a <a href="../../maps/sharing-and-collaboration/comments">comment</a> was deleted</td><td>Contains the commentId, authorId, and the location of the reply using anchor values.</td></tr><tr><td>BuilderCommentReopened</td><td>A previously resolved <a href="../../maps/sharing-and-collaboration/comments">comment</a> was reopened</td><td>Contains the commentId, authorId, anchor, updated contentLength, hyperlinksCount, and mentions, along with map and user identifiers.</td></tr><tr><td>BuilderCommentResolved</td><td>A <a href="../../maps/sharing-and-collaboration/comments">comment</a> was marked as resolved</td><td>Same structure as BuilderCommentReopened, describing the resolved state with all related metadata.</td></tr><tr><td>BuilderCommentsMarkAllAsRead</td><td>User marked all <a href="../../maps/sharing-and-collaboration/comments">comment</a> threads as read</td><td>Includes a list of commentIds affected, the mapId, and the user and account performing the action.</td></tr><tr><td>BuilderCommentsUnsplit</td><td>Split-view <a href="../../maps/sharing-and-collaboration/comments">comments</a> were merged into a single view</td><td>Contains the affected commentIds, mapId, the user performing the action, and a resolved boolean flag indicating state.</td></tr><tr><td>BuilderCustomAggResolution</td><td>On a Builder map, an editor changed the <a href="https://github.com/CartoDB/gitbook-documentation/blob/master/carto-user-manual/settings/activity-data/broken-reference/README.md">aggregation resolution</a> of a spatial index source</td><td>Contains info about the map, the user and the aggregation type</td></tr><tr><td>BuilderDataExport</td><td>Someone <a href="../../maps/exporting-data">exported data</a> from a Builder map</td><td>Contains info about the user, the map, the export type and the number of exported layers</td></tr><tr><td>BuilderMaskCreated</td><td>Someone used the <a href="../../maps/feature-selection-tool">Feature Selection tool</a> on a Builder map</td><td>Contains info about the user, the map, and the type of mask created</td></tr><tr><td>BuilderQueryThisTable</td><td>An editor used the <a href="../../maps/data-sources">Query This Table</a> feature in Builder</td><td>Contains info about the user, the map, and the connection provider</td></tr><tr><td>BuilderRefreshDataSource</td><td>An editor requested the <a href="../../../maps/data-sources/managing-data-freshness#refresh-data-manually">most up-to-date data</a> from a Builder data source</td><td>Contains info about the user, the map, and the connection provider</td></tr><tr><td>BuilderReportDownload</td><td>Someone downloaded a <a href="../../maps/download-pdf-reports">PDF export</a> of a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>BuilderURLParameterUsed</td><td><a href="../../maps/sharing-and-collaboration/url-parameters">URL Parameters </a>were used to control a Builder map</td><td>Contains info about the user, the map, and the URL parameters used</td></tr><tr><td>CartoAccessConsent</td><td>An admin gave or revoked consent for the CARTO Support Team to access the org</td><td>Contains info about the admin, the action (enable/disable) and the duration for the consent</td></tr><tr><td>CartoDWAccessGranted</td><td>A user obtained <a href="../../../connections/carto-data-warehouse#accessing-the-console">console access to the CARTO Data Warehouse</a></td><td>Contains info about the user</td></tr><tr><td>CartoDWAccessRevoked</td><td>A user self-revoked <a href="../../../connections/carto-data-warehouse#accessing-the-console">console access to the CARTO Data Warehouse</a></td><td>Contains info about the user</td></tr><tr><td>ChangeDatasource</td><td>A <a href="../../maps/data-sources">data source</a> in Builder was swapped.</td><td>Contains info about the user, the type of swap, and the map ID containing the data source</td></tr><tr><td>ConnectionBookmarkCreated</td><td>A user bookmarked a table in a connection</td><td>Contains info about the connection, table, and user</td></tr><tr><td>ConnectionBookmarkDeleted</td><td>A user removed a bookmark from a connection </td><td>Contains info about the connection, table, and user</td></tr><tr><td>ConnectionCreated</td><td>A new <a href="../../connections">connection </a>was created</td><td>Contains info about the user, the provider, the connection privacy, and the connection method</td></tr><tr><td>ConnectionDeleted</td><td>A <a href="../../connections">connection</a> was deleted</td><td>Contains info about the user, the provider, the connection privacy, and the connection method</td></tr><tr><td>ConnectionOwnershipTransferred</td><td>Ownership of a <a href="../../connections">connection</a> was transferred to another user</td><td>Contains info about the connection, previous owner, and new owner</td></tr><tr><td>ConnectionProviderSelected</td><td>When creating a <a href="../../connections">connection</a>, a provider was selected</td><td>Contains info about the user and the connection provider</td></tr><tr><td>ConnectionUpdated</td><td>A <a href="../../connections">connection</a> was updated</td><td>Contains info about the user, the provider, the connection privacy (including the previous value), and the connection method</td></tr><tr><td>ConnectionTransferred</td><td>A <a href="../../connections">connection</a> was transferred to another location</td><td>Contains info about the connection and transfer method</td></tr><tr><td>ConnectionViewerCredentialsDeleted</td><td>A user removed their credentials from a <a href="../../connections">connection</a> that requires <a href="../../../connections/sharing-a-connection#require-viewer-credentials">viewer credentials</a></td><td>Contains info about the user, the provider, the connection, and the credentials type</td></tr><tr><td>ConnectionViewerCredentialsUpdated</td><td>A user attached their credentials to a <a href="../../connections">connection</a> that requires <a href="../../../connections/sharing-a-connection#require-viewer-credentials">viewer credentials</a></td><td>Contains info about the user, the provider, the connection, and the credentials type</td></tr><tr><td>CopyEmbedCode</td><td>An editor copied the <a href="../../maps/sharing-and-collaboration/embedding-maps">embed code</a> provided in a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>CopyMapId</td><td>An editor copied the map ID provided in a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>CopyMapLink</td><td>An editor copied the <a href="../../maps/sharing-and-collaboration">map link</a> provided in a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>CopyMapToken</td><td>A user copied the <a href="../../maps/sharing-and-collaboration">map token</a></td><td>Contains info about the map</td></tr><tr><td>CrossFilteringWidgetSettingsChanged</td><td>Cross filtering settings were changed for a <a href="../../maps/widgets">widget</a></td><td>Contains info about the map, widget and cross filtering setting</td></tr><tr><td>CustomAIModelAdded</td><td>A custom <a href="../carto-ai">AI</a> model configuration was added</td><td>Contains info about the AI provider, base URL, and models configured</td></tr><tr><td>CustomAIModelRemoved</td><td>A custom <a href="../carto-ai">AI</a> model configuration was removed</td><td>Contains info about the AI provider, base URL, and models configured that were configured</td></tr><tr><td>CustomAIModelUpdated</td><td>A custom <a href="../carto-ai">AI</a> model configuration was updated</td><td>Contains info about the AI provider, base URL, and models configured</td></tr><tr><td>DataExplorerItemBrowsed</td><td>A user previewed a specific table using <a href="../../data-explorer">Data Explorer</a></td><td>Contains info about the user, the provider and the connection</td></tr><tr><td>DataExplorerItemsListed</td><td>A user listed the contents of a project/schema/dataset/database using <a href="../../data-explorer">Data Explorer</a></td><td>Contains info about the FQN, the connection, the user, the provider, the privacy, and the object type/level/count</td></tr><tr><td>DataExplorerMapCreated</td><td>A user created a map starting from a table in <a href="../../data-explorer">Data Explorer</a></td><td>Contains info about the user, the provider, and the connection</td></tr><tr><td>DataExplorerWorkflowCreated</td><td>A user created a workflow starting from a table in <a href="../../data-explorer">Data Explorer</a></td><td>Contains info about the user, the provider, and the connection</td></tr><tr><td>DataSourceCreated</td><td>A user added a new <a href="../../maps/data-sources">data source</a> to a Builder map</td><td>Contains info about the user, the provider, the source type, the connection and the map.</td></tr><tr><td>DataSourceUpdated</td><td>A user updated a <a href="../../maps/data-sources">data source</a> in a Builder map</td><td>Contains info about the user, the provider, the source type, the connection and the map.</td></tr><tr><td>DataSourceDeleted</td><td>A user deleted a <a href="../../maps/data-sources">data source</a> in a Builder map</td><td>Contains info about the user, the provider, the source type, the connection and the map.</td></tr><tr><td>DemoMapCreated</td><td>A user created a new map from one of the demo map templates that appear when onboarding into CARTO</td><td>Contains info about the user, the map, the map privacy, and the specific demo map used</td></tr><tr><td>DemoMapDuplicated</td><td>A user duplicated a new map from one of the demo map templates that appear when onboarding into CARTO</td><td>Contains info about the user, and the specific demo map duplicated</td></tr><tr><td>DemoWorkflowCreated</td><td>A user created a new workflow from one of the demo map templates that appear when onboarding into CARTO</td><td>Contains info about the user, the workflow, the workflow privacy, and the specific demo workflow used</td></tr><tr><td>DemoWorkflowDuplicated</td><td>A user duplicated a new workflow from one of the demo map templates that appear when onboarding into CARTO</td><td>Contains info about the user, and the specific demo workflow duplicated</td></tr><tr><td>DOAccessIn</td><td>A user used the "Access In" feature in <a href="../../data-explorer">Data Explorer</a> to access their <a href="../../data-observatory/accessing-your-subscriptions-from-your-data-warehouse">Data Observatory subscriptions</a> from their Data Warehouse</td><td>Contains info about the user, the dataset, and the provider</td></tr><tr><td>DOAccessInRequest</td><td>A user requested the "Access In" feature in <a href="../../data-explorer">Data Explorer</a> to access their <a href="../../data-observatory/accessing-your-subscriptions-from-your-data-warehouse">Data Observatory subscriptions</a> from their Data Warehouse</td><td>Contains info about the user, the requested dataset, and the requested provider</td></tr><tr><td>DOEntitlementCreated</td><td>A new <a href="../../data-observatory">Data Observatory subscription</a> was created for your organization</td><td>Contains info about the user and the dataset</td></tr><tr><td>DOEntitlementUpdated</td><td>An existing <a href="../../data-observatory">Data Observatory subscription</a> was updated</td><td>Contains info about the user and the dataset</td></tr><tr><td>DomainUpdated</td><td>The main domain of your <a href="..">CARTO organization</a> was updated</td><td>Contains info about the old domain and the new domain</td></tr><tr><td>DOMapCreated</td><td>A map was created starting from a <a href="../../data-observatory">Data Observatory subscription</a></td><td>Contains info about the user and the provider</td></tr><tr><td>DOSampleEntitlementCreated</td><td>A new sample was accessed from the <a href="../../data-observatory">Data Observatory</a></td><td>Contains info about the user and the dataset sample</td></tr><tr><td>DOSubscriptionRequested</td><td>A user requested a premium or under-request <a href="../../data-observatory">Data Observatory subscription</a></td><td>Contains info about the user and the requested dataset</td></tr><tr><td>EmailSent</td><td>CARTO sent a transactional email to a user</td><td>Contains info about the list of recipient users and the subject of the email</td></tr><tr><td>FileImportCreated</td><td>A user <a href="../../data-explorer/importing-data">imported a file</a> using CARTO</td><td>Contains info about the user, the provider, the connection, and the import job ID</td></tr><tr><td>GeocodeLaunched</td><td>A user started a geocoding process using <a href="../../data-explorer/geocoding-data">Data Explorer</a></td><td>Contains info about the user, the provider, the geocoding type, and the connection</td></tr><tr><td>GroupCreated</td><td>A new <a href="../users-and-groups/managing-user-groups">user group</a> was created in your organization</td><td>Contains info about the admin that created the group, and the new group ID</td></tr><tr><td>GroupDeleted</td><td>A existing <a href="../users-and-groups/managing-user-groups">user group</a> was deleted from your organization</td><td>Contains info about the group Id that was deleted, and the admin who deleted it</td></tr><tr><td>GroupUpdated</td><td>An existing <a href="../users-and-groups/managing-user-groups">user group</a> was updated</td><td>Contains info about the user that triggered the update and the group ID</td></tr><tr><td>HelpSidebarBlockClick</td><td>A user clicked on one of the help blocks in the <a href="../../../overview/carto-workspace-overview#help-sidebar">Help Sidebar</a></td><td>Contains info about the user, the context, and the specific help block</td></tr><tr><td>HelpSidebarOpened</td><td>A user opened the <a href="../../../overview/carto-workspace-overview#help-sidebar">Help Sidebar</a></td><td>Contains info about the user and the context</td></tr><tr><td>HelpSidebarSearchQuery</td><td>Someone used the AI-powered search bar in the <a href="../../../overview/carto-workspace-overview#help-sidebar">Help Sidebar</a></td><td>Contains info about the user and the context</td></tr><tr><td>HexColorColumnStyled</td><td>A user styled a layer in a Builder map <a href="https://github.com/CartoDB/gitbook-documentation/blob/master/carto-user-manual/settings/activity-data/broken-reference/README.md">using a HEX column</a> coming from their data</td><td>Contains info about the user and the map</td></tr><tr><td>HttpRequestConsumed</td><td>A workflow used the <a href="../../../workflows/components/input-output#http-request">HTTP Request component</a> and consumed HTTP Request quota</td><td>Contains info about the user and the URL requested</td></tr><tr><td>ImportDropFileLoaded</td><td>A file was loaded via drag and drop </td><td>Contains info about the file name, type, and variant</td></tr><tr><td>ImportStatusChanged</td><td>An <a href="../../data-explorer/importing-data">import job</a> changed its status</td><td>Contains info about the import job ID, the status, the elapsed time, the file type, and the schema detection mode</td></tr><tr><td>IntegrationCreated</td><td>A new <a href="../advanced-settings">integration</a> was created in Settings</td><td>Contains info about the admin and the integration type</td></tr><tr><td>IntegrationDeleted</td><td>An <a href="../advanced-settings">integration</a> was deleted in Settings</td><td>Contains info about the admin and the integration type</td></tr><tr><td>IntegrationUpdated</td><td>An <a href="../advanced-settings">integration</a> was updated in Settings</td><td>Contains info about the admin and the integration type</td></tr><tr><td>IntegrationVerificationFailed</td><td>CARTO tried to validate an <a href="../advanced-settings">integration</a>, but it failed</td><td>Contains info about the admin, the integration type, and the specific error</td></tr><tr><td>InvitationDeleted</td><td>A <a href="../users-and-groups/inviting-users-to-your-organization">user invitation</a> was deleted</td><td>Contains info about the admin who deleted the invite</td></tr><tr><td>InvitationSent</td><td>A <a href="../users-and-groups/inviting-users-to-your-organization">user invitation</a> was sent</td><td>Contains info about the admin who sent the invite</td></tr><tr><td>InviteUsersMainMenuClicked</td><td>The shortcut to <a href="../users-and-groups/inviting-users-to-your-organization">invite new users </a>from the main menu was used</td><td>Contains info about the user</td></tr><tr><td>JoinRequestApproved</td><td>An admin approved a user that <a href="../users-and-groups">requested</a> to join the organization</td><td>Contains info about the approved user</td></tr><tr><td>JoinRequestRejected</td><td>An admin rejected a user that <a href="../users-and-groups">requested</a> to join the organization</td><td>Contains info about the rejected user</td></tr><tr><td>LayerAggregateByGeometry</td><td><a href="../../maps/layers">Layer</a> aggregation by geometry was configured</td><td>Contains info about the map and geometry type</td></tr><tr><td>LayerMapListStatusChanged</td><td>A<a href="../../maps/layers"> layer</a>'s map list status was changed</td><td>Contains info about the map, layer, and state</td></tr><tr><td>LayerTypeChanged</td><td>A <a href="../../maps/layers">layer type</a> was changed in CARTO Builder</td><td>Contains info about the user and the new layer type</td></tr><tr><td>LdsConsumed</td><td><a href="../../understanding-your-organization-quotas#location-data-services-lds">LDS</a> (geocoding, routing, isolines, etc.) quota was consumed</td><td>Contains info about the user, the LDS service, the provider, the config, and the amount of LDS quota consumed</td></tr><tr><td>LdsRequestGotOverquota</td><td>The <a href="../../understanding-your-organization-quotas#location-data-services-lds">LDS quota</a> is exhausted, and a user requested more quota</td><td>Contains info about the user, the LDS service, the provider, the config, and the amount of LDS quota consumed</td></tr><tr><td>LegendVisibilityChanged</td><td><a href="../../maps/legend">Legend</a> visibility was toggled for a layer</td><td>Contains info about the map, layer, and state</td></tr><tr><td>MapCopyCoordinates</td><td>A user copied coordinates from the map</td><td>Contains info about the map</td></tr><tr><td>MapCreated</td><td>A new <a href="../../maps">Builder map</a> was created</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapCreatedFromOldVersion</td><td>A new map was created from an <a href="../../maps/version-history">old version</a></td><td>Contains info aobut the original map, version, and new map</td></tr><tr><td>MapDeleted</td><td>A <a href="../../maps">Builder map</a> was deleted</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapDescriptionCreated</td><td>An editor edited the <a href="../../maps/map-description">map description</a> of a Builder map</td><td>Contains info about the user</td></tr><tr><td>MapDescriptionUsed</td><td>A viewer opened the <a href="../../maps/map-description">map description</a> in a Builder map</td><td>Contains info about the user</td></tr><tr><td>MapDuplicated</td><td>A <a href="../../maps">Builder map</a> was duplicated</td><td>Contains info about the user, the map, the map privacy, whether it's a demo map, and the new duplicated map ID</td></tr><tr><td>MapEditMode</td><td>An editor switched to <a href="../../maps/sharing-and-collaboration/map-preview-for-editors">Edit mode</a> in a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>MapGetCoordinates</td><td>A user requested coordinates from the map</td><td>Contains info about the map</td></tr><tr><td>MapInstantiationInvalidated</td><td>The <a href="../../maps/data-sources/managing-data-freshness">cache for a data source</a> was invalidated</td><td>Contains info about the user, the provider, the connection, and the specific source</td></tr><tr><td>MapLoadedEvent</td><td>A <a href="../../maps">Builder map</a> was loaded</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapLocked</td><td>An editor started editing a <a href="../../maps/sharing-and-collaboration/collaborative-maps">collaborative map</a></td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapPreviewMode</td><td>An editor switched to <a href="../../maps/sharing-and-collaboration/map-preview-for-editors">Preview mode</a> in a Builder map</td><td>Contains info about the user and the map</td></tr><tr><td>MapPrivacyChanged</td><td>Someone changed the <a href="../../maps/sharing-and-collaboration">sharing/privacy settings</a> of a Builder map</td><td>Contains info about the user, the map, the map privacy, the previous map privacy and whether it's a demo map</td></tr><tr><td>MapPublishUpdate</td><td>Someone made <a href="../../../maps/sharing-and-collaboration#publishing-updates-for-shared-and-public-maps">the latest changes</a> in a Builder map available to viewers</td><td>Contains info about the user and the map</td></tr><tr><td>MapsListed</td><td>Someone <a href="../../maps">listed maps</a> in their CARTO Workspace</td><td>Contains info about the user</td></tr><tr><td>MapOwnershipTransferred</td><td>Ownership of a Builder map was transferred to another user</td><td>Contains info about the map, previous owner, and new owner</td></tr><tr><td>MapSelectedForAIAgentCreation</td><td>A map was selected for creating an <a href="../../ai-agents">AI Agent</a></td><td>Contains info about the map</td></tr><tr><td>MapSnapshotCreated</td><td>Changes in a <a href="../../maps">Builder map</a> were automatically saved</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapTakeoverAccept</td><td>In a <a href="../../maps/sharing-and-collaboration/collaborative-maps">collaborative map</a>, the current editor accepted that other editor will take over editing</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapTakeoverReject</td><td>In a <a href="../../maps/sharing-and-collaboration/collaborative-maps">collaborative map</a>, the current editor rejected that other editor will take over editing</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapTakeoverRequest</td><td>In a <a href="../../maps/sharing-and-collaboration/collaborative-maps">collaborative map</a>, an editor requested to take over editing from the current editing user</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapUnlocked</td><td>In a <a href="../../maps/sharing-and-collaboration/collaborative-maps">collaborative map</a>, the current editor stopped editing it and now other editors can jump in</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapUpdated</td><td>A <a href="../../maps">Builder map</a> was updated</td><td>Contains info about the user, the map, the map privacy, and whether it's a demo map</td></tr><tr><td>MapUpdatesPublished</td><td>Someone made <a href="../../../maps/sharing-and-collaboration#publishing-updates-for-shared-and-public-maps">the latest changes</a> in a Builder map available to viewers</td><td>Contains info about the user, the map, and the specific widgets used</td></tr><tr><td>MapVersionCreated</td><td>A new <a href="../../maps/version-history">version</a> of a map was created</td><td>Contains info about the map, version, title, and description</td></tr><tr><td>MapVersionManagerOpened</td><td>The map <a href="../../maps/version-history">version</a> manager was opened</td><td>Contains info about the map</td></tr><tr><td>MapVersionUpdated</td><td>A map <a href="../../maps/version-history">version</a> was updated</td><td>Contains info about the map, version, title, and description</td></tr><tr><td>MapVersionRestored</td><td>A previous <a href="../../maps/version-history">version</a> of a map was restored</td><td>Contains info about the map, and version</td></tr><tr><td>MeasureToolUsed</td><td>A user measured distances in a Builder map using the <a href="../../maps/measure-distances">measure tool</a></td><td>Contains info about the user and the map</td></tr><tr><td>NamedSourceCreated</td><td>A <a href="../../developers/named-sources">Named Source</a> was created in your organization</td><td>Contains info about the user and the named source</td></tr><tr><td>NamedSourceDeleted</td><td>A <a href="../../developers/named-sources">Named Source</a> was deleted in your organization</td><td>Contains info about the user and the named source</td></tr><tr><td>NamedSourceUpdated</td><td>A <a href="../../developers/named-sources">Named Source</a> was updated in your organization</td><td>Contains info about the user and the named source</td></tr><tr><td>ObjectMetadata</td><td>This event is fired every time a data resource (table or query) is used in CARTO</td><td>Contains info about the user, the FQN used, the provider and connection details, and metadata about this object</td></tr><tr><td>OnboardingCompleted</td><td>A user completed all the <a href="../../../overview/carto-workspace-overview#getting-started">onboarding tasks</a></td><td>Contains info about the user</td></tr><tr><td>OnboardingItemChecked</td><td>A user completed one of the <a href="../../../overview/carto-workspace-overview#getting-started">onboarding tasks</a></td><td>Contains info about the user and the specific task</td></tr><tr><td>OnboardingOpened</td><td>A user opened their <a href="../../../overview/carto-workspace-overview#getting-started">onboarding tasks</a></td><td>Contains info about the user</td></tr><tr><td>OnboardingSkipped</td><td>A user skipped the <a href="../../../overview/carto-workspace-overview#getting-started">onboarding tasks</a></td><td>Contains info about the user</td></tr><tr><td>OpenAPIAccessTokens</td><td>A user opened their <a href="../../developers/managing-credentials">Credentials</a> section</td><td>Contains info about the user</td></tr><tr><td>OpenApplications</td><td>The <a href="../../applications">Applications section</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenBuilderMap</td><td>A <a href="../../maps">Builder map</a> was opened</td><td>Contains info about the user, the map, and the map privacy</td></tr><tr><td>OpenConnections</td><td>The <a href="../../connections">Connections section</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenDE</td><td>The <a href="../../data-explorer">Data Explorer</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenDevelopers</td><td>The <a href="../../developers">Developers section</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenDO</td><td>The <a href="../../data-observatory">Data Observatory</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenHomePage</td><td>The <a href="../../../overview/carto-workspace-overview#homepage">CARTO Workspace homepage</a> was opened</td><td>Contains info about the user</td></tr><tr><td>OpenSettings</td><td>The <a href="..">Settings</a> were opened</td><td>Contains info about the admin</td></tr><tr><td>OpenWorkflow</td><td>A <a href="../../workflows">Workflow</a> was opened</td><td>Contains info about the user and the specific workflow</td></tr><tr><td>OptimizeTableLaunched</td><td>A <a href="../../data-explorer/optimizing-your-data">table was optimized for geospatial analysis</a> using Data Explorer</td><td>Contains info about the user, the connection, and the FQN of the optimized table</td></tr><tr><td>QuotaUXTriggered</td><td>An action was stopped because a <a href="../understanding-your-organization-quotas">quota</a> is exhausted</td><td>Contains info about the user, the specific quota, and the UI where this alert was raised</td></tr><tr><td>ResourceDeleted</td><td>A table was deleted using <a href="../../data-explorer">Data Explorer</a></td><td>Contains info about the user, the FQN of the deleted resource, and the connection used</td></tr><tr><td>SettingsCartoAIDisabled</td><td><a href="../carto-ai">CARTO AI</a> features were disabled for the organization</td><td>Contains info about the admin who disabled the feature</td></tr><tr><td>SettingsCartoAIEnabled</td><td><a href="../carto-ai">CARTO AI</a> features were enabled for the organization</td><td>Contains info about the admin who enabled the feature</td></tr><tr><td>ShowOnlyThis</td><td>Someone used the "Show only this layer" function in Builder </td><td>Contains info about the user and the map</td></tr><tr><td>SpatialColumnTypeDefined</td><td>A different Spatial Column (and type) was specified in a Builder map</td><td>Contains info about the user, the spatial type, and the spatial column name</td></tr><tr><td>SQLAnalysisCreated</td><td>A <a href="../../maps/sql-analyses">SQL Analysis</a> was generated in a Builder map</td><td>Contains info about the user, the map, the analysis type, and additional metadata</td></tr><tr><td>SQLParameterCreated</td><td>A <a href="../../maps/sql-parameters">SQL Parameter</a> was added to a Builder map</td><td>Contains info about the user, the type of SQL parameter, and the map</td></tr><tr><td>SQLParameterUsed</td><td>A <a href="../../maps/sql-parameters">SQL Parameter</a> was used in a Builder map</td><td>Contains info about the user, the type of SQL parameter, the map, and the map privacy</td></tr><tr><td>SyncUserGroups</td><td><a href="../users-and-groups/managing-user-groups">Groups in CARTO </a>were updated using info from your SSO</td><td>Contains info about the user, the added groups for that user, and the removed groups for that user</td></tr><tr><td>TableUsedDetails</td><td>The specified table resource was used somewhere in CARTO</td><td>Contains info about the user, the context, the FQN, the object type, the connection, and the provider</td></tr><tr><td>TableWidgetInteraction</td><td>A user interacted with a <a href="../../maps/widgets/table-widget">table widget</a> in Builder</td><td>Contains info about the user, the map, and the interaction type</td></tr><tr><td>TilesetCreated</td><td>A <a href="https://github.com/CartoDB/gitbook-documentation/blob/master/carto-user-manual/settings/activity-data/broken-reference/README.md">tileset</a> was created using Data Explorer</td><td>Contains info about the user, the connection, and additional metadata</td></tr><tr><td>TokenCreated</td><td>An <a href="../../developers/managing-credentials/api-access-tokens">API Access Token</a> was created</td><td>Contains info about the user and the token</td></tr><tr><td>TokenDeleted</td><td>An <a href="../../developers/managing-credentials/api-access-tokens">API Access Token</a> was deleted</td><td>Contains info about the user and the token</td></tr><tr><td>TokenM2MCreated</td><td>An <a href="../../../carto-for-developers/key-concepts/authentication-methods/oauth-access-tokens">OAuth Access Token</a> was obtained using a <a href="../../developers/managing-credentials/m2m-oauth-clients">M2M OAuth Client</a></td><td>Contains info about the user and the remaining M2M OAuth Tokens quota</td></tr><tr><td>TokenOwnershipTransferred</td><td>Ownership of an API Access Token was transferred to another user</td><td>Contains info about the token, previous owner, and new owner</td></tr><tr><td>TokenUpdated</td><td>An <a href="../../developers/managing-credentials/api-access-tokens">API Access Token</a> was updated</td><td>Contains info about the user and the token</td></tr><tr><td>UserCreated</td><td>A <a href="../users-and-groups">new user joined your organization</a></td><td>Contains info about the user, the method used to join, and additional organization information</td></tr><tr><td>UserDeleted</td><td>A <a href="../users-and-groups/deleting-users">user in your organization</a> was deleted</td><td>Contains info about the user and role of the deleted user</td></tr><tr><td>UserLogins</td><td>A user logged in</td><td>Contains info about the user</td></tr><tr><td>UserLogout</td><td>A user logged out manually from CARTO</td><td>Contains info about the user</td></tr><tr><td>UserRoleUpdated</td><td>The <a href="../users-and-groups/managing-user-roles">role of a user</a> in your organization was updated</td><td>Contains info about the user, their previous role, and the new role</td></tr><tr><td>UserUpdated</td><td>A <a href="../users-and-groups">user in your organization</a> was updated</td><td>Contains info about the user</td></tr><tr><td>WidgetAggregationUsed</td><td>A <a href="../../maps/widgets">widget</a> aggregation was used</td><td>Contains info about the map, widget type, and aggregation type</td></tr><tr><td>WidgetFilteringInteraction</td><td>A user interacted with <a href="../../maps/widgets">widget</a> filtering</td><td>Contains info about the map and widget</td></tr><tr><td>WorkflowApiExecuted</td><td>A Workflow was <a href="../../workflows/executing-workflows-via-api">executed via API</a></td><td>Contains info about the user, the workflow, and the provider</td></tr><tr><td>WorkflowCreated</td><td>A <a href="../../workflows">Workflow</a> was created</td><td>Contains info about the user, the workflow, the privacy, the provider, and the connection</td></tr><tr><td>WorkflowDeleted</td><td>A <a href="../../../workflows/managing-maps#deleting-workflows">Workflow</a> was deleted</td><td>Contains info about the user, the deleted workflow, the privacy, the provider, and the connection</td></tr><tr><td>WorkflowDuplicated</td><td>A <a href="../../workflows">Workflow</a> was duplicated</td><td>Contains info about the user, the workflow, the privacy, the provider, the connection, and the new duplicated workflow ID</td></tr><tr><td>WorkflowExecutionComplete</td><td>A <a href="../../workflows">Workflow</a> was successfully executed</td><td>Contains the user, the workflow, and very specific comprehensive details about the workflow components used and their results</td></tr><tr><td>WorkflowLocked</td><td>An editor started editing a collaborative <a href="../../workflows">Workflow</a></td><td>Contains info about the user and the workflow. </td></tr><tr><td>WorkflowMapCreated</td><td>A Builder map was <a href="../../workflows/results-panel">created from a Workflow</a> results table</td><td>Contains info about the user, the workflow, and the workflow component from where the map was created</td></tr><tr><td>WorkflowPrivacyChanged</td><td>A Workflow <a href="../../workflows/sharing-workflows">sharing/privacy settings</a> were updated</td><td>Contains info about the user, the workflow, the original privacy, and the new privacy</td></tr><tr><td>WorkflowRun</td><td>A <a href="../../workflows">Workflow</a> was executed via UI</td><td>Contains info about the user, the workflow, the provider, and the components used</td></tr><tr><td>WorkflowUnlocked</td><td>In a collaborative <a href="../../workflows">Workflow</a>, the current Editor stopped editing</td><td>Contains info about the workflow</td></tr><tr><td>WorkflowsAPIDisabled</td><td>A Workflow was disabled to be <a href="../../workflows/executing-workflows-via-api">called from an API endpoint</a></td><td>Contains info about the user and the workflow</td></tr><tr><td>WorkflowsAPIEnabled</td><td>A Workflow was enabled to be <a href="../../workflows/executing-workflows-via-api">called from an API endpoint</a></td><td>Contains info about the user and the workflow</td></tr><tr><td>WorkflowsExtensionInstalled</td><td>A <a href="../../workflows/extension-packages">Workflow extension</a> was installed for the organization</td><td>Contains info about the user and the installed extension name, author, and provider</td></tr><tr><td>WorkflowsExtensionFailed</td><td>A <a href="../../workflows/extension-packages">Workflow extension</a> failed to load</td><td>Contains info about the extension</td></tr><tr><td>WorkflowsExtensionUninstalled</td><td>A <a href="../../workflows/extension-packages">Workflow extension</a> was uninstalled from the organization</td><td>Contains info about the user and the uninstalled extension name, author, and provider</td></tr><tr><td>WorkflowScheduleCreated</td><td>A <a href="../../workflows/scheduling-workflows">Workflow was scheduled</a> to run at a certain period</td><td>Contains info about the user, the provider, and the workflow</td></tr><tr><td>WorkflowScheduleDeleted</td><td>The <a href="../../workflows/scheduling-workflows">schedule of a Workflow</a> was deleted</td><td>Contains info about the user, the provider, and the workflow</td></tr><tr><td>WorkflowScheduleUpdated</td><td>The <a href="../../workflows/scheduling-workflows">schedule of a Workflow</a> was updated</td><td>Contains info about the user, the provider, and the workflow</td></tr><tr><td>WorkflowsFileDeleted</td><td>A <a href="../../../workflows/data-sources#files">data file</a> was removed from a Workflow</td><td>Contains info about the user, the workflow, and the deleted file</td></tr><tr><td>WorkflowsFileLoaded</td><td>A <a href="../../../workflows/data-sources#files">data file was imported</a> into a Workflow</td><td>Contains info about the user, the workflow, and the deleted file</td></tr><tr><td>WorkflowsListed</td><td>A user listed <a href="../../workflows">Workflows</a> using CARTO Workspace</td><td>Contains info about the user</td></tr><tr><td>WorkflowsMcpToolEnabled</td><td>The MCP tool feature was enabled for a workflow</td><td>Contains info about the workflow</td></tr><tr><td>WorkflowsMcpToolDisabled</td><td>The MCP tool feature was disabled for a workflow</td><td>Contains info about the workflow</td></tr><tr><td>WorkflowOwnershipTransferred</td><td>Ownership of a workflow was transferred to another user</td><td>Contains info about the workflow, previous owner, and new owner</td></tr><tr><td>WorkflowsResultCopied</td><td>A user copied <a href="../../workflows/results-panel">the results of a Workflow</a></td><td>Contains info about the user and the workflow</td></tr><tr><td>WorkflowsResultPaginationLengthChanged</td><td>A user changed the page size <a href="../../workflows/results-panel">browsing the results of a Workflow</a></td><td>Contains info about the user, the workflow, and the new pagination length</td></tr><tr><td>WorkflowsResultPaginationNavigationAction</td><td>A user used the pagination while <a href="../../workflows/results-panel">browsing the results of a Workflow</a></td><td>Contains info about the user and the workflow</td></tr><tr><td>WorkflowsSQLExported</td><td>A user exported a Workflow <a href="../../../workflows/sharing-workflows#export-a-workflow-as-a-sql-file">as a SQL file</a></td><td>Contains info about the user and the workflow</td></tr><tr><td>WorkflowTemplateCreated</td><td>Someone created a workflow from a template</td><td>Contains info about the user, the connection provider, and the template title</td></tr><tr><td>WorkflowsTemplateExplored</td><td>Someone explored a Workflow template</td><td>Contains info about the user</td></tr><tr><td>WorkflowsVariableAdded</td><td>A <a href="../../workflows/using-variables-in-workflows">variable</a> was added to a Workflow</td><td>Contains info about the user, the workflow, and the variable type</td></tr><tr><td>WorkflowsVariableUsed</td><td>A <a href="../../workflows/using-variables-in-workflows">variable</a> was used in a Workflow</td><td>Contains info about the user, the workflow, and the component where the variable was used</td></tr><tr><td>WorkflowUpdated</td><td>A <a href="../../workflows">Workflow</a> was updated</td><td>Contains info about the user, the privacy, the connection, and the provider used</td></tr><tr><td>ZoomToLayer</td><td>Someone used the "Zoom to layer" function in a CARTO Builder map</td><td>Contains info about the user and the map</td></tr></tbody></table>

## API Usage

A daily aggregation by user, API and component of your API usage, used to calculate your [Usage Quota](https://docs.carto.com/carto-user-manual/settings/understanding-your-organization-quotas).

### Schema

| Column               | Type      | Description                                                                                                                                                                                                                                          |
| -------------------- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ts                   | TIMESTAMP | timestamp of the usage (daily)                                                                                                                                                                                                                       |
| user\_id             | STRING    | User that produced the usage. `public` means an unauthenticated user (for example, a public Builder map viewer).                                                                                                                                     |
| metric               | STRING    | A combination of API + method + client.                                                                                                                                                                                                              |
| amount               | NUMBER    | The amount of API requests for that day, user and metric. Multiply by the weight in quota\_usage\_weight to obtain the [usage quota consumed](https://docs.carto.com/carto-user-manual/settings/understanding-your-organization-quotas) for that row |
| quota\_usage\_weight | NUMBER    | The weight applied to that specific metric for [quota calculations](https://docs.carto.com/carto-user-manual/settings/understanding-your-organization-quotas)                                                                                        |

## User List

A relationship between the ID and the email of all the current [users](https://docs.carto.com/carto-user-manual/settings/users-and-groups) in your organization, as well as their role and group membership.

{% hint style="info" %}
Some events in the [Activity Logs](#activity-logs) may contain a userId called `public`. That user won't be present in this list, and it means that we weren't able to attribute the event to any known user. That happens, for example, for unauthenticated visitors of public maps, or in custom applications that use your own login system.
{% endhint %}

### Schema

| Field name  | Type         | Description                                                                                                                     |
| ----------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| user\_id    | STRING       | <p>Unique user identifier. The first part contains information about the authentication method:<br><br>- <code>auth0</code></p> |
| email       | STRING       | User email                                                                                                                      |
| created\_at | TIMESTAMP    | Date and time of the user creation                                                                                              |
| role        | STRING       | <p>Current role of the user. Possible values:<br>- Admin<br>- Editor<br>- Viewer</p>                                            |
| group\_ids  | STRING ARRAY | List of [group IDs](#group-list) that this user belongs to                                                                      |

## Group List

A relationship between the ID and the name of all the current [groups](https://docs.carto.com/carto-user-manual/settings/users-and-groups/managing-user-groups) in your organization

### Schema

| Field name   | Type   | Description                                                                                                                                  |
| ------------ | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| group\_id    | STRING | The ID of the [group](https://docs.carto.com/carto-user-manual/settings/users-and-groups/managing-user-groups)                               |
| group\_alias | STRING | The user-facing alias corresponding to this [group](https://docs.carto.com/carto-user-manual/settings/users-and-groups/managing-user-groups) |
