Board activity logs

Query board-scoped activity_logs on the Board type (nested under boards)

This page documents the activity_logs field on Board — nested only under a boards query.

For user-level activity (users { activity_logs }), rate limits, the 2026-07 API version requirement, and the roadmap for cross-board / cross-user queries, see the main Activity logs guide.

Activity logs on a board are records of actions performed on that board. You can use them to see which actions were performed, when, and by whom.

Queries

Get board activity logs

🚧

This API changes starting from version 2027-01. From 2027-01, board activity logs include more entities, are limited to events from the last 90 days, and use cursor pagination. The description below applies to versions before 2027-01. For 2027-01 and later, see Get board activity logs in 2027-01 and later.

  • Required scope: boards:read
  • Limit: up to 10,000 logs
  • Returns an array containing metadata about a collection of activity logs from a specific board in reverse chronological order
  • Can only be nested within a boards query
query {
  boards(
    ids: [1234567890]
  ) {
    activity_logs(
      from: "2021-07-23T00:00:00Z"
      to: "2021-07-26T00:00:00Z"
    ) {
      id
      event
      data
    }
  }
}
import { ApiClient } from "@mondaydotcomorg/api";
const mondayApiClient = new ApiClient({ token: myToken });

const query = `query ($board_id: [ID!], $from: ISO8601DateTime!, $to: ISO8601DateTime!) { boards (ids: $board_id) { activity_logs (from: $from, to: $to) { id event data }}}`;
const variables = {
  board_id: 1234567890,
  from: "2024-07-23T00:00:00Z",
  to: "2024-07-26T00:00:00Z",
};
const response = await mondayApiClient.request(query, variables);

Arguments

ArgumentTypeDescription
column_ids[String]The specific columns to return events for.
fromISO8601DateTimeFrom timestamp (ISO8601).
group_ids[String]The specific groups to return events for.
item_ids[ID!]The specific items to return events for.
limitIntThe number of activity log events to return. The default is 25.
pageIntThe page number to return. Starts at 1.
toISO8601DateTimeTo timestamp (ISO8601).
user_ids[ID!]The specific users to return events for.

Fields

FieldTypeDescriptionEnum Values
account_idString!The unique identifier of the account that initiated the event.
dataString!The item's column values.
entityString!The entity of the event that was changed. Use this field — entity_id is not available on ActivityLogType.board
pulse
eventString!The action that took place.
idString!The unique identifier of the activity log event.
user_idString!The unique identifier of the user who initiated the event.
created_atString!The time of the event in 17-digit Unix time. To convert the timestamp to UNIX time in milliseconds, divide the 17-digit value by 10,000 and round to the nearest integer. For UNIX time in seconds, divide the value by 10,000,000.

Get board activity logs in 2027-01 and later

🚧

Only available in API versions 2027-01 and later

  • Required scope: boards:read
  • Returns a BoardActivityLogsPage with the board's activity log entries and a cursor for the next page
  • Only returns events from the last 90 days. Requests for data older than 90 days return a validation error
  • Uses cursor pagination instead of page
  • Can only be nested within a boards query

In the examples below, replace FROM_TIMESTAMP and TO_TIMESTAMP with ISO 8601 timestamps (for example, 2027-01-05T00:00:00Z). FROM_TIMESTAMP must be within the last 90 days.

query {
  boards(ids: [1234567890]) {
    activity_logs(
      from: "FROM_TIMESTAMP"
      to: "TO_TIMESTAMP"
      limit: 25
    ) {
      cursor
      logs {
        id
        event
        entity
        data
        user_id
        created_at
      }
    }
  }
}

To fetch the next page, pass the cursor value from the previous response. When cursor is null, there are no more pages.

query {
  boards(ids: [1234567890]) {
    activity_logs(
      from: "FROM_TIMESTAMP"
      to: "TO_TIMESTAMP"
      limit: 25
      cursor: "CURSOR_FROM_PREVIOUS_RESPONSE"
    ) {
      cursor
      logs {
        id
        event
      }
    }
  }
}

Arguments

ArgumentTypeDescription
column_ids[ID!]The specific columns to return events for.
correlation_ids[ID!]Filter by correlation IDs to retrieve all events belonging to the same logical session.
cursorStringThe cursor for fetching the next page, obtained from a previous response.
event_types[String!]Filter by event types (for example, create_pulse or delete_pulse).
fromStringFrom timestamp (ISO 8601), max 90 days ago.
group_ids[ID!]The specific groups to return events for.
item_ids[ID!]The specific items to return events for.
limitIntThe number of activity log events to return (1-1000, default 25).
searchStringFree-text prefix search over item names.
toStringTo timestamp (ISO 8601).
user_ids[ID!]The specific users to return events for.

Fields

BoardActivityLogsPage:

FieldTypeDescription
logs[ActivityLog!]The activity log entries for this page.
cursorStringThe cursor to pass to fetch the next page. null if this is the last page.

ActivityLog:

FieldTypeDescription
idIDThe unique identifier of the activity log entry.
account_idIDThe account this activity log entry belongs to.
user_idIDThe user who performed the action.
eventStringThe type of event that occurred.
entityStringThe entity type that was affected.
dataStringAdditional data associated with the event, as a JSON string.
created_atStringThe timestamp when the activity log entry was created.
correlation_idIDGroups all activity log entries belonging to the same logical session (for example, an agent conversation).
triggering_flow_idIDThe ID of the triggering flow (for example, an agent run UUID).
triggering_flow_typeStringThe type of triggering flow (for example, agent_run).

Changes in 2027-01

TopicBefore 2027-012027-01 and later
Return type[ActivityLogType]BoardActivityLogsPage
Paginationpage and limit (default 25)cursor and limit (1-1000, default 25)
page argumentIntRemoved
from and toISO8601DateTimeString (ISO 8601); from is at most 90 days ago
column_ids[String][ID!]
group_ids[String][ID!]
New arguments—event_types, correlation_ids, cursor, search