List CRM changes
https://api.ruuster.com/v1/crm/changesThe audit record of changes made to your CRM through Ruuster, newest first. Every request (in the person's words), who asked and from where, what it did, when it was confirmed and completed, and how many people were changed, skipped or failed, including previews that were never confirmed.
- Authentication:
x-api-keyandx-emailheaders of an owner or admin - Rate limit: 120 requests per minute per key
Everything asked of your CRM through Ruuster stays on record and can't be deleted: every preview (confirmed or not), who asked for it (the Ruuster login and whether it came through an AI assistant), the request in the person's words, the action and its values, when it was confirmed, cancelled or completed, and the counts. Filter by status, by day, or to the changes that touched one CRM person. For one change's people with their before and after values, and its full history, use Get a CRM change. No CRM key is needed.
Query parameters
| Name | Type | Default | Description |
|---|---|---|---|
status |
open | proposed | applying | completed | completed_with_errors | cancelled |
Only changes in this state; open is proposed or applying. An unconfirmed preview past its window shows as expired |
|
from |
date | Changes created on or after this day, YYYY-MM-DD in America/Chicago |
|
to |
date | Changes created before this day, YYYY-MM-DD, excluded |
|
personId |
string | Only changes that included this CRM person id | |
cursor |
string | meta.nextCursor from the previous page |
|
limit |
integer | 25 |
Changes per page, 1 to 100 |
Response
data.changes[], newest first: changeId, status (proposed, expired, applying, completed, completed_with_errors, cancelled), action, summary, request, params, source, undoOf, vendor, crmAccount, crmUser (the CRM user the key belongs to), requestedBy (email, role, client: mcp or direct), counts (requested, willChange, skipped, done, failed), warnings, createdAt, expiresAt, confirmedAt, completedAt, cancelledAt, lastError.