Changes
What changed on a board or an item, in order, for following it.
List a board's changes
GET/v1/boards/{boardId}/changes
The changes to a board's items, columns, groups and the board itself after a place, oldest first. Leave out after to get no changes and the latest place in nextPlace: note it before you load the board, then pass it as after to follow what changes next. While hasMore is true, more changes are waiting. A group's delete or restore is one change, board_group_deleted or board_group_restored, not one per item: read it as the group's items going to the trash with it, or coming back. An item moved to another group or place is item_moved, except that an unarchive or restore that puts the item at the end of the board's first group, because its own group is in the trash, writes only item_unarchived or item_restored: read the item for its group. Skip a kind you do not know: new ones can be added. A place higher than your workspace's latest answers 400 CHANGE_PLACE_UNKNOWN; reload the board.
Who can call: Any API key.
Path parameters
boardIdstringrequired
The board's ID.
- Pattern
^brd_[0-9a-z]{21}$
- Pattern
Query parameters
afterintegeroptional
Return the changes after this place: a whole number, the
nextPlaceof your last answer. Leave it out to get no changes and the latest place.- At least 0
limitintegeroptional
How many changes at most: a whole number from 1 to 1,000. 100 if left out.
- 1 to 1,000
Answer200 OK
changesarray of Changerequired
The board's changes after
after, oldest first, up tolimit. Empty whenafteris left out.Show 10 fieldsHide 10 fields
placeintegerrequired
The change's place in the feed. Places only grow, but they have gaps: pass back the place you were given and never count from it.
- At least 0
boardIdstringrequired
The board the change is on.
- Pattern
^brd_[0-9a-z]{21}$
- Pattern
kindstringrequired
What happened: an item, column or board was created, changed, archived, deleted or restored; an item's notes were saved (
notes_edited); a board group was created, updated, reordered, deleted or restored (board_group_…); or an item moved to another group or place (item_moved; an unarchive or restore that puts the item in the board's first group, because its own group is in the trash, writes onlyitem_unarchivedoritem_restored). Skip a kind you do not know: new ones can be added.- One of
"item_created","item_changed","item_archived","item_unarchived","item_deleted","item_restored","notes_edited","column_created","column_changed","column_deleted","column_restored","board_created","board_changed","board_deleted","board_restored","board_group_created","board_group_updated","board_group_reordered","board_group_deleted","board_group_restored","item_moved"
- One of
actorTypestringrequired
Who made the change:
memberfor a person,api_keyfor an API key.automationandintegrationare kept for later.- One of
"member","api_key","automation","integration"
- One of
actorIdstringrequired
The person's user ID, or the key's ID when
actorTypeisapi_key(the answer'sapiKeysnames it).itemIdstring or nullrequired
The item that changed. Null for a column, board or group change.
- Pattern
^itm_[0-9a-z]{21}$
- Pattern
columnIdstring or nullrequired
The field that changed. For
item_changed, the column ID, ornamefor the item's name. For a column change, the column's ID. Forboard_changed, the board field. For a group change other thanboard_group_reordered, the group's ID. Null for the other kinds.oldValueChangeValue or nullrequired
The value before the change, as stored, or null. A column change holds the column's definition. A value emptied by a type change or a removed label stays here.
board_group_updatedandboard_group_deletedhold the group as it was, andboard_group_deletedaddsitemCount, the items that went with it.board_group_reorderedholds the old order as{ids}, anditem_movedwhere the item was, as{groupId, position}.newValueChangeValue or nullrequired
The value after the change, as stored, or null when it was emptied.
item_createdholds the new item as{name, values, groupId, position}; one written before groups has nogroupIdorposition. A column change holds the column's definition.board_group_created,board_group_updatedandboard_group_restoredhold the group as{id, name, color, position}, andboard_group_restoredaddsitemCount, the items that came back with it.board_group_reorderedholds the new order as{ids}, anditem_movedwhere the item is, as{groupId, position}. Archive, unarchive, delete, restore andnotes_editedhold null.createdAtstringrequired
When the change was made, in UTC.
- Format
date-time(ISO 8601)
- Format
nextPlaceintegerrequired
The place to pass as
afternext time: the last change's place, or your workspace's latest place when there are no changes.- At least 0
hasMorebooleanrequired
True when
limitcut the list and more changes are waiting. Ask again withnextPlace.apiKeysarray of NamedApiKeyrequired
The API keys that made any of these changes (
actorTypeapi_key), with their names. Revoked keys are named too.Show 3 fieldsHide 3 fields
idstringrequired
The key's ID:
apk_and 21 characters. Never the key itself.- Pattern
^apk_[0-9a-z]{21}$
- Pattern
namestringrequired
The name the key was given.
revokedbooleanrequired
True when the key was revoked. What it did stays.
Errors
INVALID_REQUEST400 Bad Request
The body, a query parameter or the
Idempotency-Keydoes not match its schema, or the request names something the board does not have or allow, such as a column order that is not every column once or the board's last view to delete. An ID in the path that is not shaped like one answers 404 instead. Some refusals carrydetails.reason, which says why, anddetails.field, which names the field when one is at fault.CHANGE_PLACE_UNKNOWN400 Bad Request
The
afterplace is one the changes feed does not know: higher than your workspace's latest. Ask withoutafterfor the latest place, then load the board again.UNAUTHENTICATED401 Unauthorized
No key was sent, or the key does not work: the header is not
Bearer <key>, the key is from another environment, unknown, revoked or expired, or its maker is no longer an owner or admin or its workspace is not active. The answer is the same in every case; when the request had anAuthorizationheader, it comes withWWW-Authenticate: Bearer.NOT_FOUND404 Not Found
There is no such board, column, view, group, item or update in the key's workspace (another workspace's counts as none, and so does another board's group in the path), or it was deleted while the request ran. A restore of a board, column or group that is not in the trash answers it too. Nothing is written.
RATE_LIMITED429 Too Many Requests
Too many calls in the last 60 seconds: by the key, by its workspace's keys together, or from your address with keys that do not work. Only keys of the right shape count against your address; a header or key of the wrong shape answers 401 and is not counted. Send it again after
Retry-Afterseconds.With
Retry-After: 10, the seconds to wait before sending again.INTERNAL500 Internal Server Error
Something went wrong on our side. Try again later.
Example
curl "https://api.melonforce.com/v1/boards/brd_7k2m9x4p1q8v3z6n5t0wr/changes?after=0&limit=100" \
-H "Authorization: Bearer $MELONFORCE_API_KEY"{
"changes": [
{
"place": 41868,
"boardId": "brd_7k2m9x4p1q8v3z6n5t0wr",
"kind": "board_created",
"actorType": "member",
"actorId": "Q3vR7nX2kLp9sT4wYb8mZc1dF6gHj0aE",
"itemId": null,
"columnId": null,
"oldValue": null,
"newValue": {
"name": "Orders",
"itemWord": "order",
"claimEnabled": false,
"mainStatusColumnId": "status",
"mainPersonColumnId": null,
"mainDateColumnId": null,
"columns": [
{
"id": "status",
"name": "Status",
"type": "status",
"description": null,
"settings": {
"labels": [
{
"id": "k3m9x2qa",
"name": "New",
"color": "blue"
},
{
"id": "p7d2w8nc",
"name": "Packed",
"color": "amber"
},
{
"id": "r5x8c1ve",
"name": "Shipped",
"color": "teal"
}
]
},
"position": 1
}
]
},
"createdAt": "2026-11-18T13:58:40.217Z"
},
{
"place": 41870,
"boardId": "brd_7k2m9x4p1q8v3z6n5t0wr",
"kind": "item_created",
"actorType": "member",
"actorId": "Q3vR7nX2kLp9sT4wYb8mZc1dF6gHj0aE",
"itemId": "itm_3f8h1k6m0p4r7t2v9x5zb",
"columnId": null,
"oldValue": null,
"newValue": {
"name": "Order 1042",
"values": {
"status": "k3m9x2qa"
},
"groupId": "grp_7k2m9x4p1q8v3z6n5t0wr",
"position": 1024
},
"createdAt": "2026-11-18T14:01:05.932Z"
},
{
"place": 41873,
"boardId": "brd_7k2m9x4p1q8v3z6n5t0wr",
"kind": "item_changed",
"actorType": "member",
"actorId": "Q3vR7nX2kLp9sT4wYb8mZc1dF6gHj0aE",
"itemId": "itm_3f8h1k6m0p4r7t2v9x5zb",
"columnId": "status",
"oldValue": "k3m9x2qa",
"newValue": "p7d2w8nc",
"createdAt": "2026-11-18T14:03:12.481Z"
}
],
"nextPlace": 41873,
"hasMore": false,
"apiKeys": []
}List an item's changes
One item's changes, newest first. To read older ones, pass the last answer's nextBefore as before; it is null at the end. The item may be archived; a deleted item answers 404.
Who can call: Any API key.
Path parameters
itemIdstringrequired
The item's ID.
- Pattern
^itm_[0-9a-z]{21}$
- Pattern
Query parameters
beforeintegeroptional
Return the changes before this place: a whole number, the
nextBeforeof your last answer. Leave it out to start from the newest.- At least 0
limitintegeroptional
How many changes at most: a whole number from 1 to 1,000. 100 if left out.
- 1 to 1,000
Answer200 OK
changesarray of Changerequired
The item's changes, newest first, up to
limit.nextBeforeinteger or nullrequired
The place to pass as
beforeto read older changes, or null when there are no more.- At least 0
apiKeysarray of NamedApiKeyrequired
The API keys that made any of these changes (
actorTypeapi_key), with their names. Revoked keys are named too.Show 3 fieldsHide 3 fields
idstringrequired
The key's ID:
apk_and 21 characters. Never the key itself.- Pattern
^apk_[0-9a-z]{21}$
- Pattern
namestringrequired
The name the key was given.
revokedbooleanrequired
True when the key was revoked. What it did stays.
Errors
INVALID_REQUEST400 Bad Request
The body, a query parameter or the
Idempotency-Keydoes not match its schema, or the request names something the board does not have or allow, such as a column order that is not every column once or the board's last view to delete. An ID in the path that is not shaped like one answers 404 instead. Some refusals carrydetails.reason, which says why, anddetails.field, which names the field when one is at fault.UNAUTHENTICATED401 Unauthorized
No key was sent, or the key does not work: the header is not
Bearer <key>, the key is from another environment, unknown, revoked or expired, or its maker is no longer an owner or admin or its workspace is not active. The answer is the same in every case; when the request had anAuthorizationheader, it comes withWWW-Authenticate: Bearer.NOT_FOUND404 Not Found
There is no such board, column, view, group, item or update in the key's workspace (another workspace's counts as none, and so does another board's group in the path), or it was deleted while the request ran. A restore of a board, column or group that is not in the trash answers it too. Nothing is written.
RATE_LIMITED429 Too Many Requests
Too many calls in the last 60 seconds: by the key, by its workspace's keys together, or from your address with keys that do not work. Only keys of the right shape count against your address; a header or key of the wrong shape answers 401 and is not counted. Send it again after
Retry-Afterseconds.With
Retry-After: 10, the seconds to wait before sending again.INTERNAL500 Internal Server Error
Something went wrong on our side. Try again later.
Example
curl "https://api.melonforce.com/v1/items/itm_3f8h1k6m0p4r7t2v9x5zb/changes?limit=1" \
-H "Authorization: Bearer $MELONFORCE_API_KEY"{
"changes": [
{
"place": 41902,
"boardId": "brd_7k2m9x4p1q8v3z6n5t0wr",
"kind": "item_changed",
"actorType": "api_key",
"actorId": "apk_9w4c2n7h5j1b8d3g6l0qs",
"itemId": "itm_3f8h1k6m0p4r7t2v9x5zb",
"columnId": "status",
"oldValue": "p7d2w8nc",
"newValue": "r5x8c1ve",
"createdAt": "2026-11-18T15:20:47.106Z"
}
],
"nextBefore": 41902,
"apiKeys": [
{
"id": "apk_9w4c2n7h5j1b8d3g6l0qs",
"name": "Order sync",
"revoked": false
}
]
}