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.
The activity_logs
field is not a root query, you must specify one or more boards first. Querying activity logs returns a collection of activity logs in a specific board.
You can learn more about activity logs here.
query {
boards (ids: 1234567) {
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)));
curl --location --request POST 'https://api.monday.com/v2' \
--header 'Authorization: YourSuperSecretApiKey' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cfduid=d4512e647bd3dd90706f5673d6041f7c51618840981' \
--data-raw '{"query": "query { boards (ids: 1234567) { activity_logs
(from: \"2021-07-23T00:00:00Z\) { id event data }}}"}'
Arguments
The following activity log arguments can reduce the number of activity logs returned.
Argument | Description |
---|---|
limit - | The number of activity log events returned. Default is 25. |
page | The page number returned, should you implement pagination. Starts at 1. |
user_ids | User IDs that can be used to filter the events returned. |
column_ids | Column IDs that can be used to filter the events returned. |
group_ids | Group IDs that can be used to filter the events returned. |
item_ids | Item IDs that can be used to filter the events returned. |
from | From timestamp (ISO8601). |
to | To timestamp (ISO8601). |
Fields
The following fields will determine what information is returned from your activity logs queries.
Field | Description |
---|---|
account_id | The account ID that initiated the event. |
created_at | The time of the event in 17 digit unix time. |
data | The item's column values in string form. |
entity | The entity of the event that was changed (pulse / board). |
event | The action that took place. |
id | The ID of the activity log event. |
user_id | The user ID of the user who initiated the event. |
Understanding the format of 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.
Here are some examples:
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);
?>
Updated 10 months ago