Activity logs
Activity logs are records of all activities performed on a board. You can use them to see which actions were performed on your boards, when, and by whom.
As a developer working with monday.com, it is important to familiarize yourself with the activity_logs
API so you know how to see activity on your boards. This document will walk you through the available queries to read the activity_logs
object via the API.
Queries
Querying activity_logs
returns a collection of activity logs from a specific board. This method accepts various arguments and returns an array.
You can only query activity_logs
by nesting it within a boards
query, so it can't be used at the root.
query {
boards (ids: 1234567890) {
activity_logs (from: "2021-07-23T00:00:00Z", to: "2021-07-26T00:00:00Z") {
id
event
data
}
}
}
let query = 'query { boards (ids: 1234567890) { 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
You can use the following argument(s) to reduce the number of results returned in your activity_logs
query.
Argument | Description |
---|---|
column_ids [String] | The specific columns to return events for. |
from ISO8601DateTime | From timestamp (ISO8601). |
group_ids [String] | The specific groups to return events for. |
item_ids [Int] | The specific items to return events for. Please note that this argument's type is [ID!] in API versions 2023-10 and later. |
limit Int | The number of activity log events to return. The default is 25. |
page Int | The page number to return. Starts at 1. |
to ISO8601DateTime | To timestamp (ISO8601). |
user_ids [Int] | The specific users to return events for. Please note that this argument's type is [ID!] in API versions 2023-10 and later. |
Fields
You can use the following field(s) to specify what information your activity_logs
query will return.
Field | Description |
---|---|
account_id String! | The unique identifier of the account that initiated the event. |
data String! | The item's column values. |
entity String! | The entity of the event that was changed: pulse or board. |
event String! | The action that took place. |
id String! | The unique identifier of the activity log event. |
user_id String! | The unique identifier of the user who initiated the event. |
created_at String! | The time of the event in 17-digit unix time. |
Created_at
field
Created_at
fieldThe 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);
?>
Join our developer community!
We've created a community specifically for our devs where you can search through previous topics to find solutions, ask new questions, hear about new features and updates, and learn tips and tricks from other devs. Come join in on the fun! 😎
Updated 5 months ago