Skip to main content
GET
Read Changes
Returns the next page of the workspace change feed (artifact, folder, task, and workspace events, in commit order) after this API key’s acknowledged position. Reading never acknowledges: call Acknowledge with the page’s deliveryToken to move forward. Works on archived workspaces. MCP: workspace_changes. CLI: rip workspace changes <workspace-id> [--limit --delivery-token]. Auth: Authorization: Bearer tr_... (an account API key). {id} is the workspace UUID.

Query parameters

Response

Only one page is outstanding at a time. While it is, a read without its deliveryToken is refused; a read with it returns the same page. Once the token expires, the next read issues a fresh page from your acknowledged position.

Errors