Get a change
GET/v1/changes/{changeId}
Returns one change: the operation that made it, the trips it touched, and its status (applied, failed, reverting, reverted). error says why it failed or why a revert stopped.
Permissions: any valid key · Kind: read · Cost: 1 unit
Path parameters
| Field | Type | Required | Description |
|---|---|---|---|
changeId |
uuid | yes |
Query parameters
None.
Response 200
| Field | Type | Required | Description |
|---|---|---|---|
object |
"change" | yes | |
id |
uuid | yes | |
operationId |
string | yes | |
surface |
"rest" | "mcp" | yes | |
status |
"applying" | "applied" | "failed" | "reverting" | "reverted" | yes | |
tripIds |
string[] | yes | |
credentialId |
string | null | yes | |
error |
string | null | yes | |
createdAt |
string | yes | |
updatedAt |
string | yes | |
revertedAt |
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 reachednot_found— Not found