Search activity

distru-search-activityRead

Shows what changed across the company: who did it, when, and to which records.

Inputs

Every tool also takes the common inputs.

FieldTypeRequiredDescription
limitintegerNoDefault: 10
cursorstringNonextCursor of the previous call; keep the other arguments unchanged.
changedAtobjectNoInclusive. YYYY-MM-DD (whole days, company timezone) or ISO 8601 with a UTC offset. When the action started. At most 366 days, a whole year (with only start, up to 367 days ago); with only end, the 365 days before it. Default the last 7 days, or with ids whenever they ran.
changedAt.endstringNo
changedAt.startstringNo
idsstring[]NoActions by id. An entry lists the same records however it is found: only recordTypes narrows them. Resolve via distru-get-record-history (a CHANGE entry's id) or this tool.
userIdsstring[]NoActions by these users. Resolve via distru-search-users.
sourcesenum[]
16 values
AI_AGENTAUTOMATIONBIOTRACKIMPORTJOBLEGACYMCPMETRCMIGRATIONMOBILEPARTNER_APIPUBLIC_APIQUICKBOOKSSTAFF_SQLUNKNOWNWEB
No
opsenum[]
DELETEINSERTUPDATE
NoActions that created (INSERT), updated or deleted a record of a type shown.
recordTypesenum[]
47 values
ASSEMBLYAUTOMATIONBATCHBINCHARGE_PRESETCOMPANYCOMPANY_GROUPCOMPLIANCE_TRANSFERCOST_TYPECREDITCUSTOM_VALIDATIONDATASETDRIVERHARVESTINVITATIONINVOICELABEL_TEMPLATEMENUSALES_ORDERORDER_SHIPMENTPACKAGEPAYMENT_METHODPAYMENT_TERMPLANTPLANT_ADDITIVEPLANT_ADDITIVE_TYPEPLANT_GROUPPLANT_WASTEPRICE_TIERPRODUCTPRODUCT_CATEGORYPRODUCT_GROUPPURCHASERELATIONSHIP_TYPERETURNROLESCHEDULED_ALERTSTOCK_TRANSFERSTRAINTAGTAXTEAMTEARDOWNTEST_RESULTUNIT_TYPEUSERVEHICLE
NoActions on records of these types; records and recordCounts hold only these types.
sortByobjectNoDefault CHANGED_AT DESC, newest first.
sortBy.directionenum
ASCDESC
Yes
sortBy.fieldenum
CHANGED_AT
YesCHANGED_AT: when the action started, or the note was logged.

Output

Presence on a nested field assumes its parent exists.

FieldTypePresenceDescription
hasMorebooleanAlways
nextCursorstringCan be absent
totalCountintegerCan be absent
itemsobject[]Always
items[].idstringAlways
items[].changedAtstringAlways
items[].actorobjectCan be nullNull for syncs and jobs.
items[].actor.idstringCan be nullNull for Distru Support and another company's user, whose id no tool takes.
items[].actor.namestringAlways
items[].actor.companyNamestringCan be nullThe actor's company, when it isn't the record's (a buyer's user).
items[].impersonatorobjectCan be nullDistru staff acting for the actor, as Distru Support.
items[].impersonator.idstringCan be nullNull for Distru Support and another company's user, whose id no tool takes.
items[].impersonator.namestringAlways
items[].impersonator.companyNamestringCan be nullThe actor's company, when it isn't the record's (a buyer's user).
items[].sourceenum
16 values
AI_AGENTAUTOMATIONBIOTRACKIMPORTJOBLEGACYMCPMETRCMIGRATIONMOBILEPARTNER_APIPUBLIC_APIQUICKBOOKSSTAFF_SQLUNKNOWNWEB
Always
items[].sourceDetailstringCan be nullThe API key or automation name; Distru Support for a fix by Distru staff.
items[].rowCountintegerAlways
items[].truncatedbooleanAlways
items[].recordCountsobject[]AlwaysEvery record of the entry by type, including those past the 50-row cap on records.
items[].recordCounts[].typeenum
128 values
ACCOUNTASSEMBLYASSEMBLY_INPUTASSEMBLY_OUTPUTASSEMBLY_OUTPUT_BINAUTOMATIONAUTOMATION_VERSIONBATCHBILL_OF_MATERIALSBINCHARGECHARGE_PRESETCHARGE_PRESET_OWNER_TEAMCHARGE_PRESET_OWNER_USERCHARGE_PRESET_TAGCOMPANYCOMPANY_GROUPCOMPANY_SETTINGSCOMPLIANCE_DELIVERYCOMPLIANCE_TRANSFERCONTACTCOST_TYPECREDITCREDIT_USECUSTOM_FIELDCUSTOM_VALIDATIONDATASETDEFAULT_MENU_INTERNAL_ORDER_NOTIFICATIONS_RECIPIENTDRIVERHARVESTHARVEST_GROUPHARVEST_WASTEIMAGEINVITATIONINVOICEINVOICE_ITEMINVOICE_PAYMENTINVOICE_RECIPIENT_EMAILINVOICE_SIGNATURELABEL_TEMPLATELICENSELOCATIONMATERIAL_TEST_RESULTMCP_API_KEYMENUMENU_BANNER_IMAGEMENU_COLLECTIONMENU_COLLECTION_BRANDMENU_COLLECTION_IMAGEMENU_COLLECTION_OFFICIAL_PRODUCT_CATEGORYMENU_COLLECTION_PRODUCT_CATEGORYMENU_COLLECTION_PRODUCT_GROUPMENU_COLLECTION_PRODUCT_SUBCATEGORYMENU_COLLECTION_STRAINMENU_COLLECTION_STRAIN_TYPEMENU_HOLDERMENU_INTERNAL_ORDER_NOTIFICATIONS_RECIPIENTMENU_OFFICIAL_PRODUCT_CATEGORY_TO_SELL_BY_POTENCYMENU_PRICE_TIERMENU_PRODUCTMENU_URLOFFICIAL_PRODUCT_CATEGORYORDER_ITEMORDER_SHIPMENTORDER_SHIPMENT_ITEMORDER_SHIPMENT_SIGNATUREPACKAGEPACKAGE_BINPARTNERPARTNER_CONNECTIONPAYMENTPAYMENT_METHODPAYMENT_TERMPENDING_METRC_ITEMPLANTPLANT_ADDITIVEPLANT_ADDITIVE_TARGETPLANT_ADDITIVE_TYPEPLANT_GROUPPLANT_WASTEPLANT_WASTE_PLANTPRICE_TIERPRODUCTPRODUCT_CATEGORYPRODUCT_GROUPPRODUCT_SUBCATEGORYPRODUCT_TAGPROFILEPUBLIC_API_KEYPURCHASEPURCHASE_PAYMENTQB_ACCOUNTQB_AUTH_TOKENQB_CLASSQB_CUSTOMERQB_VENDORQUICKBOOKS_ITEMQUICKBOOKS_SETTINGSRECURRING_SCHEDULERELATIONSHIP_TYPEREQUESTRETURNRETURN_ITEMROLESALES_ORDERSCHEDULED_ALERTSCHEDULED_QB_EXPORTSCHEDULED_REPORTSIGNATURESTOCK_ADJUSTMENTSTOCK_TRANSFERSTOCK_TRANSFER_ITEMSTRAINTAGTASKTAXTAX_TAGTEAMTEAM_MEMBERSHIPTEARDOWNTEARDOWN_INPUTTEARDOWN_MAPPINGTEARDOWN_OUTPUTTEST_RESULTUNIT_TYPEUSERVEHICLEWEBHOOK_CONFIGURATION
Always
items[].recordCounts[].countintegerAlways
items[].recordsobject[]Always
items[].records[].typeenum
128 values
ACCOUNTASSEMBLYASSEMBLY_INPUTASSEMBLY_OUTPUTASSEMBLY_OUTPUT_BINAUTOMATIONAUTOMATION_VERSIONBATCHBILL_OF_MATERIALSBINCHARGECHARGE_PRESETCHARGE_PRESET_OWNER_TEAMCHARGE_PRESET_OWNER_USERCHARGE_PRESET_TAGCOMPANYCOMPANY_GROUPCOMPANY_SETTINGSCOMPLIANCE_DELIVERYCOMPLIANCE_TRANSFERCONTACTCOST_TYPECREDITCREDIT_USECUSTOM_FIELDCUSTOM_VALIDATIONDATASETDEFAULT_MENU_INTERNAL_ORDER_NOTIFICATIONS_RECIPIENTDRIVERHARVESTHARVEST_GROUPHARVEST_WASTEIMAGEINVITATIONINVOICEINVOICE_ITEMINVOICE_PAYMENTINVOICE_RECIPIENT_EMAILINVOICE_SIGNATURELABEL_TEMPLATELICENSELOCATIONMATERIAL_TEST_RESULTMCP_API_KEYMENUMENU_BANNER_IMAGEMENU_COLLECTIONMENU_COLLECTION_BRANDMENU_COLLECTION_IMAGEMENU_COLLECTION_OFFICIAL_PRODUCT_CATEGORYMENU_COLLECTION_PRODUCT_CATEGORYMENU_COLLECTION_PRODUCT_GROUPMENU_COLLECTION_PRODUCT_SUBCATEGORYMENU_COLLECTION_STRAINMENU_COLLECTION_STRAIN_TYPEMENU_HOLDERMENU_INTERNAL_ORDER_NOTIFICATIONS_RECIPIENTMENU_OFFICIAL_PRODUCT_CATEGORY_TO_SELL_BY_POTENCYMENU_PRICE_TIERMENU_PRODUCTMENU_URLOFFICIAL_PRODUCT_CATEGORYORDER_ITEMORDER_SHIPMENTORDER_SHIPMENT_ITEMORDER_SHIPMENT_SIGNATUREPACKAGEPACKAGE_BINPARTNERPARTNER_CONNECTIONPAYMENTPAYMENT_METHODPAYMENT_TERMPENDING_METRC_ITEMPLANTPLANT_ADDITIVEPLANT_ADDITIVE_TARGETPLANT_ADDITIVE_TYPEPLANT_GROUPPLANT_WASTEPLANT_WASTE_PLANTPRICE_TIERPRODUCTPRODUCT_CATEGORYPRODUCT_GROUPPRODUCT_SUBCATEGORYPRODUCT_TAGPROFILEPUBLIC_API_KEYPURCHASEPURCHASE_PAYMENTQB_ACCOUNTQB_AUTH_TOKENQB_CLASSQB_CUSTOMERQB_VENDORQUICKBOOKS_ITEMQUICKBOOKS_SETTINGSRECURRING_SCHEDULERELATIONSHIP_TYPEREQUESTRETURNRETURN_ITEMROLESALES_ORDERSCHEDULED_ALERTSCHEDULED_QB_EXPORTSCHEDULED_REPORTSIGNATURESTOCK_ADJUSTMENTSTOCK_TRANSFERSTOCK_TRANSFER_ITEMSTRAINTAGTASKTAXTAX_TAGTEAMTEAM_MEMBERSHIPTEARDOWNTEARDOWN_INPUTTEARDOWN_MAPPINGTEARDOWN_OUTPUTTEST_RESULTUNIT_TYPEUSERVEHICLEWEBHOOK_CONFIGURATION
Can be nullNull for rows whose record is gone.
items[].records[].idstringCan be absentLeft out when the MCP takes that type's ids nowhere; QuickBooks ids are raw.
items[].records[].namestringCan be nullThe record's current name (its last one once deleted), not its name then.
items[].records[].openum
DELETEINSERTUPDATE
AlwaysINSERT or DELETE when the action created or deleted the record itself; a change to its lines alone is an UPDATE.
items[].records[].changedFieldsstring[]Always
items[].records[].rowCountintegerAlways
items[].records[].truncatedbooleanAlways
What the AI reads

Company-wide activity feed: one entry per action (a save, import, sync, job or automation run) with the records it changed, each by its current name. Each record lists the names of its changed fields (a line's as `orderItem.quantity`), not their values. For values, for who changed one record, or for a record with no changedFields (changed only through an event or a field the caller can't see), use distru-get-record-history. Shows only the records the caller may see. No notes: those are only on distru-get-record-history. An entry reads its first 50 rows; truncated marks the rest, and recordCounts counts every record. A page can hold fewer entries than limit, even none, while hasMore is true: keep following nextCursor.