Skip to content
MelonforceAPI docs

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

boardId

stringrequired

The board's ID.

  • Pattern ^brd_[0-9a-z]{21}$

Query parameters

after

integeroptional

Return the changes after this place: a whole number, the nextPlace of your last answer. Leave it out to get no changes and the latest place.

  • At least 0
limit

integeroptional

How many changes at most: a whole number from 1 to 1,000. 100 if left out.

  • 1 to 1,000

Answer200 OK

changes

array of Changerequired

The board's changes after after, oldest first, up to limit. Empty when after is left out.

Show 10 fieldsHide 10 fields
place

integerrequired

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
boardId

stringrequired

The board the change is on.

  • Pattern ^brd_[0-9a-z]{21}$
kind

stringrequired

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 only item_unarchived or item_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"
actorType

stringrequired

Who made the change: member for a person, api_key for an API key. automation and integration are kept for later.

  • One of "member", "api_key", "automation", "integration"
actorId

stringrequired

The person's user ID, or the key's ID when actorType is api_key (the answer's apiKeys names it).

itemId

string or nullrequired

The item that changed. Null for a column, board or group change.

  • Pattern ^itm_[0-9a-z]{21}$
columnId

string or nullrequired

The field that changed. For item_changed, the column ID, or name for the item's name. For a column change, the column's ID. For board_changed, the board field. For a group change other than board_group_reordered, the group's ID. Null for the other kinds.

oldValue

ChangeValue 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_updated and board_group_deleted hold the group as it was, and board_group_deleted adds itemCount, the items that went with it. board_group_reordered holds the old order as {ids}, and item_moved where the item was, as {groupId, position}.

newValue

ChangeValue or nullrequired

The value after the change, as stored, or null when it was emptied. item_created holds the new item as {name, values, groupId, position}; one written before groups has no groupId or position. A column change holds the column's definition. board_group_created, board_group_updated and board_group_restored hold the group as {id, name, color, position}, and board_group_restored adds itemCount, the items that came back with it. board_group_reordered holds the new order as {ids}, and item_moved where the item is, as {groupId, position}. Archive, unarchive, delete, restore and notes_edited hold null.

createdAt

stringrequired

When the change was made, in UTC.

  • Format date-time (ISO 8601)
nextPlace

integerrequired

The place to pass as after next time: the last change's place, or your workspace's latest place when there are no changes.

  • At least 0
hasMore

booleanrequired

True when limit cut the list and more changes are waiting. Ask again with nextPlace.

apiKeys

array of NamedApiKeyrequired

The API keys that made any of these changes (actorType api_key), with their names. Revoked keys are named too.

Show 3 fieldsHide 3 fields
id

stringrequired

The key's ID: apk_ and 21 characters. Never the key itself.

  • Pattern ^apk_[0-9a-z]{21}$
name

stringrequired

The name the key was given.

revoked

booleanrequired

True when the key was revoked. What it did stays.

Errors

INVALID_REQUEST

400 Bad Request

The body, a query parameter or the Idempotency-Key does 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 carry details.reason, which says why, and details.field, which names the field when one is at fault.

CHANGE_PLACE_UNKNOWN

400 Bad Request

The after place is one the changes feed does not know: higher than your workspace's latest. Ask without after for the latest place, then load the board again.

UNAUTHENTICATED

401 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 an Authorization header, it comes with WWW-Authenticate: Bearer.

NOT_FOUND

404 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_LIMITED

429 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-After seconds.

With Retry-After: 10, the seconds to wait before sending again.

INTERNAL

500 Internal Server Error

Something went wrong on our side. Try again later.

Example

Request
curl "https://api.melonforce.com/v1/boards/brd_7k2m9x4p1q8v3z6n5t0wr/changes?after=0&limit=100" \
  -H "Authorization: Bearer $MELONFORCE_API_KEY"
200 OK
{
  "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

GET/v1/items/{itemId}/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

itemId

stringrequired

The item's ID.

  • Pattern ^itm_[0-9a-z]{21}$

Query parameters

before

integeroptional

Return the changes before this place: a whole number, the nextBefore of your last answer. Leave it out to start from the newest.

  • At least 0
limit

integeroptional

How many changes at most: a whole number from 1 to 1,000. 100 if left out.

  • 1 to 1,000

Answer200 OK

changes

array of Changerequired

The item's changes, newest first, up to limit.

Same fields as changes in List a board's changes

nextBefore

integer or nullrequired

The place to pass as before to read older changes, or null when there are no more.

  • At least 0
apiKeys

array of NamedApiKeyrequired

The API keys that made any of these changes (actorType api_key), with their names. Revoked keys are named too.

Show 3 fieldsHide 3 fields
id

stringrequired

The key's ID: apk_ and 21 characters. Never the key itself.

  • Pattern ^apk_[0-9a-z]{21}$
name

stringrequired

The name the key was given.

revoked

booleanrequired

True when the key was revoked. What it did stays.

Errors

INVALID_REQUEST

400 Bad Request

The body, a query parameter or the Idempotency-Key does 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 carry details.reason, which says why, and details.field, which names the field when one is at fault.

UNAUTHENTICATED

401 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 an Authorization header, it comes with WWW-Authenticate: Bearer.

NOT_FOUND

404 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_LIMITED

429 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-After seconds.

With Retry-After: 10, the seconds to wait before sending again.

INTERNAL

500 Internal Server Error

Something went wrong on our side. Try again later.

Example

Request
curl "https://api.melonforce.com/v1/items/itm_3f8h1k6m0p4r7t2v9x5zb/changes?limit=1" \
  -H "Authorization: Bearer $MELONFORCE_API_KEY"
200 OK
{
  "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
    }
  ]
}