List changes
GET/v1/changes
Lists the changes this key's owner made through the API, from any of their keys, REST or MCP, most recently updated first — limited to the areas this key can read. Every undoable write records one and returns its id in the Bymundi-Change-Id header. Filter by tripId (a quote's changes carry its trip), status and thisKeyOnly=true, and page with nextCursor. updatedSince also catches reverts.
Permissions: any valid key · Kind: read · Cost: 1 unit · MCP tool list_changes
Path parameters
None.
Query parameters
| 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 |
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"list" | yes | |
data |
object[] | yes | |
data[].object |
"change" | yes | |
data[].id |
uuid | yes | |
data[].operationId |
string | yes | |
data[].surface |
"rest" | "mcp" | yes | |
data[].status |
"applying" | "applied" | "failed" | "reverting" | "reverted" | yes | |
data[].tripIds |
string[] | yes | |
data[].credentialId |
string | null | yes | |
data[].error |
string | null | yes | |
data[].createdAt |
string | yes | |
data[].updatedAt |
string | yes | |
data[].revertedAt |
string | null | yes | |
nextCursor |
string | null | yes |
Errors
Errors are problem details. Besides the refusals described above, any call like this one can return:
invalid_request— Invalid requestunauthorized— Missing or invalid API keyinsufficient_scope— Missing permissionrate_limited— Rate limit reached