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. A workspace in the trash answers 410 WORKSPACE_DELETED. 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. History sequence numbers are positions in a fixed catch-up window, not visible-event counts or content revisions. Load may show current content alongside an older window. Consume, replay, and explicitly acknowledge the delivered page to reach the next window. Acknowledgment consumes history; it cannot resolve a content-write conflict. Browser rendering and polling never acknowledge visible work.

Errors