bymundi API

List changes

The list_changes MCP tool: list changes.

list_changes · read-only

REST: GET /v1/changes

What the model reads

Lists the changes you made through the API or MCP, most recently updated first — from any of your keys, or only this one with thisKeyOnly: true, and only in the areas this key can read. Every undoable write names its change id in its result. Filter by tripId and status; pass nextCursor back as cursor for the next page. undo_change reverts one.

Permissions: any valid key.

Input

Field Type Required Description
tripId uuid
status "applying" | "applied" | "failed" | "reverting" | "reverted"
updatedSince datetime
thisKeyOnly boolean | "true" | "false" Only the changes made with THIS key.
sort "updatedAt" | "-updatedAt" | "createdAt" | "-createdAt" default "-updatedAt"
limit integer 1–100, default 25
cursor string max 500 chars

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "tripId": {
      "type": "string",
      "format": "uuid"
    },
    "status": {
      "type": "string",
      "enum": [
        "applying",
        "applied",
        "failed",
        "reverting",
        "reverted"
      ]
    },
    "updatedSince": {
      "type": "string",
      "format": "date-time"
    },
    "thisKeyOnly": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "string",
          "enum": [
            "true",
            "false"
          ]
        }
      ],
      "description": "Only the changes made with THIS key."
    },
    "sort": {
      "type": "string",
      "enum": [
        "updatedAt",
        "-updatedAt",
        "createdAt",
        "-createdAt"
      ],
      "default": "-updatedAt"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    }
  },
  "additionalProperties": false
}