--- title: "List all activity logs" method: GET path: "/admins/activity_logs" tags: ["Admins"] --- # List all activity logs `GET /admins/activity_logs` You can get a log of activities by all admins in an app. ## Query parameters - `created_at_after` string, required - `created_at_before` string ## Headers - `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.
By default, it's equal to the version set in the app package. ## Response `200` Successful response - ActivityLogList — A paginated list of activity logs. - `type` string — String representing the object's type. Always has the value `activity_log.list`. - `pages` CursorPages, nullable — Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed. - `type` 'pages' — the type of object `pages`. - `page` integer — The current page - `next` StartingAfterPaging, nullable - `per_page` integer — The number of results to fetch per page. - `starting_after` string, nullable — The cursor to use in the next request to get the next page of results. - `per_page` integer — Number of results per page - `total_pages` integer — Total number of pages - `activity_logs` ActivityLog[] — An array of activity logs - `id` string — The id representing the activity. - `performed_by` object — Details about the Admin involved in the activity. - `type` string — String representing the object's type. Always has the value `admin`. - `id` string — The id representing the admin. - `email` string — The email of the admin. - `ip` string — The IP address of the admin. - `metadata` ActivityLogMetadata, nullable — Additional data provided about Admin activity. - `sign_in_method` string, nullable — The way the admin signed in. - `external_id` string, nullable — The unique identifier for the contact which is provided by the Client. - `away_mode` boolean, nullable — The away mode status which is set to true when away and false when returned. - `away_status_reason` string, nullable — The reason the Admin is away. - `reassign_conversations` boolean, nullable — Indicates if conversations should be reassigned while an Admin is away. - `source` string, nullable — The action that initiated the status change. - `auto_changed` string, nullable — Indicates if the status was changed automatically or manually. - `update_by` integer, nullable — The ID of the Admin who initiated the activity. - `update_by_name` string, nullable — The name of the Admin who initiated the activity. - `previous_state` string, nullable — The state before the change. `idle` or `occupied`, and null when the Admin had not been classified yet. - `new_state` string, nullable — The state after the change. `idle` or `occupied`. - `threshold_minutes` integer, nullable — The inactivity window, in minutes, used to classify the Admin. - `last_activity_at` integer, nullable — The time of the Admin's last recorded activity. - `auto` boolean, nullable — Indicates the state was derived automatically rather than set by an Admin. - `setting_type` string, nullable — The group of workspace settings the change belongs to, for example `teammate_occupancy` or `automatic_away_mode`. - `changes` object, nullable — The settings altered by the change, keyed by setting name. Only settings whose value actually moved are included, so an unchanged setting is absent rather than present with equal values. - `conversation_assignment_limit` integer, nullable — The conversation assignment limit value for an admin. - `ticket_assignment_limit` integer, nullable — The ticket assignment limit value for an admin. - `team` object, nullable — Details about the team whose assignment limit was changed. - `id` integer — The ID of the team. - `name` string — The name of the team. - `team_assignment_limit` integer, nullable — The team assignment limit value (null if limit was removed). - `enabled` boolean, nullable — Indicates if the setting is enabled or disabled. - `consent_id` integer, nullable — The ID of the impersonation consent. - `expired_at` string, date-time, nullable — The timestamp when the impersonation consent expires. - `before` object, nullable — The state of settings or values before the change. Structure varies by activity type. - `after` object, nullable — The state of settings or values after the change. Structure varies by activity type. - `created_at` integer — The time the activity was created. - `activity_type` 'admin_conversation_assignment_limit_change' | 'admin_ticket_assignment_limit_change' | 'admin_avatar_change' | 'admin_away_mode_change' | 'admin_deletion' | 'admin_deprovisioned' | 'admin_impersonation_end' | 'admin_impersonation_start' | 'admin_impersonation_consent_approved' | 'admin_impersonation_consent_revoked' | 'admin_invite_change' | 'admin_invite_creation' | 'admin_invite_deletion' | 'admin_login_failure' | 'admin_login_success' | 'admin_logout' | 'admin_occupancy_setting_change' | 'admin_occupancy_state_change' | 'admin_password_reset_request' | 'admin_password_reset_success' | 'admin_permission_change' | 'admin_provisioned' | 'admin_two_factor_auth_change' | 'admin_unauthorized_sign_in_method' | 'app_admin_join' | 'app_authentication_method_change' | 'app_data_deletion' | 'app_data_export' | 'app_google_sso_domain_change' | 'app_identity_verification_change' | 'app_name_change' | 'app_outbound_address_change' | 'app_package_installation' | 'app_package_token_regeneration' | 'app_package_uninstallation' | 'app_team_creation' | 'app_team_deletion' | 'app_team_membership_modification' | 'app_timezone_change' | 'app_webhook_creation' | 'app_webhook_deletion' | 'articles_in_messenger_enabled_change' | 'automatic_away_mode_setting_change' | 'bulk_delete' | 'bulk_export' | 'campaign_deletion' | 'campaign_state_change' | 'conversation_part_deletion' | 'conversation_pdf_export' | 'conversation_topic_change' | 'conversation_topic_creation' | 'conversation_topic_deletion' | 'custom_authentication_token_creation' | 'customer_facing_name_change' | 'help_center_settings_change' | 'inbound_conversations_change' | 'inbox_access_change' | 'macro_creation' | 'macro_deletion' | 'macro_update' | 'macro_usage_export' | 'malicious_domains_setting_change' | 'message_deletion' | 'message_state_change' | 'messenger_api_secret_creation' | 'messenger_api_secret_deletion' | 'messenger_look_and_feel_change' | 'messenger_search_required_change' | 'messenger_spaces_change' | 'oauth_token_revocation' | 'office_hours_change' | 'role_change' | 'role_creation' | 'role_deletion' | 'ruleset_activation_title_preview' | 'ruleset_creation' | 'ruleset_deletion' | 'search_browse_enabled_change' | 'search_browse_required_change' | 'seat_change' | 'seat_revoke' | 'security_settings_change' | 'series_creation' | 'series_deletion' | 'series_settings_update' | 'series_status_change' | 'series_update' | 'strip_inbound_email_links_change' | 'temporary_expectation_change' | 'team_assignment_limit_change' | 'trusted_domains_setting_change' | 'unassign_unsnoozed_at_capacity_setting_change' | 'unassign_unsnoozed_when_away_setting_change' | 'upfront_email_collection_change' | 'allowed_attachment_filetypes_setting_change' | 'attach_uploads_inline_setting_change' | 'teammate_gifs_setting_change' | 'user_camera_attachments_setting_change' | 'user_conversation_attachments_setting_change' | 'user_file_attachments_setting_change' | 'user_gifs_setting_change' | 'user_media_attachments_setting_change' | 'user_voice_notes_setting_change' | 'welcome_message_change' | 'workspace_deletion_request' - `activity_description` string — A sentence or two describing the activity. ## Other responses - `401` — Unauthorized --- [API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)