Activity logs

monday.com activity logs are records of all activities performed on a board. Use them to see which actions were performed on your boards.

Activity logs queries

The activity_logs field is available to query through boards. The field must be nested within another query, so you cannot use it at the root of your query. Querying activity logs returns a collection of activity logs in a specific board.

You can retrieve up to 10,000 records at a time. If you want to retrieve more than that, you can use arguments in your queries to help filter the results.

query {
  boards (ids: 123456789) {
    activity_logs (from: "2021-07-23T00:00:00Z", to: "2021-07-26T00:00:00Z") {
      id
      event
      data
    }
  }
}
let query = 'query { boards (ids: 123456789) { activity_logs (from: \"2021-07-23T00:00:00Z\", to: \"2021-07-26T00:00:00Z\") { id event data }}}';


fetch ("https://api.monday.com/v2", {
  method: 'post',
  headers: {
    'Content-Type': 'application/json',
    'Authorization' : 'YOUR_API_KEY_HERE'
   },
   body: JSON.stringify({
     'query' : query
   })
  })
   .then(res => res.json())
   .then(res => console.log(JSON.stringify(res, null, 2)));

Arguments

The following activity log arguments can reduce the number of activity logs returned.

ArgumentDescription
limit IntThe number of activity log events returned. Default is 25.
page IntThe page number returned, should you implement pagination. Starts at 1.
user_ids [Int]User IDs that can be used to filter the events returned.
column_ids StringColumn IDs that can be used to filter the events returned.
group_ids StringGroup IDs that can be used to filter the events returned.
item_ids IntItem IDs that can be used to filter the events returned.
from ISO8601DateTimeFrom timestamp (ISO8601).
to ISO8601DateTimeTo timestamp (ISO8601).

Fields

The following fields will determine what information is returned from your activity logs queries.

FieldDescription
account_id String!The account ID that initiated the event.
created_at String!The time of the event in 17-digit unix time.
data String!The item's column values in string form.
entity String!The entity of the event that was changed (pulse / board).
event String!The action that took place.
id String!The ID of the activity log event.
user_id String!The user ID of the user who initiated the event.

Understanding the created_at field

The timestamps returned by this field are formatted as UNIX time with 17 digits.

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.

myDate = new Date(15880281464518396 / 10000)
import pandas as pd  
pd.to_datetime(16155031105053254 / 10000000, unit='s')
<?php
$timestamp=16155031105053254/10000000;
echo gmdate("Y-m-d\TH:i:s\Z", $timestamp);
?>

πŸ“˜

Have questions?

Join our developer community! You can share your questions and learn from fellow users and monday.com product experts.

Don’t forget to search before opening a new topic!