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.
Argument | Description |
---|---|
limit Int | The number of activity log events returned. Default is 25. |
page Int | The 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 String | Column IDs that can be used to filter the events returned. |
group_ids String | Group IDs that can be used to filter the events returned. |
item_ids Int | Item IDs that can be used to filter the events returned. |
from ISO8601DateTime | From timestamp (ISO8601). |
to ISO8601DateTime | To timestamp (ISO8601). |
Fields
The following fields will determine what information is returned from your activity logs queries.
Field | Description |
---|---|
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
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);
?>
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!
Updated 5 days ago