Search activity
distru-search-activityReadShows what changed across the company: who did it, when, and to which records.
Inputs
Every tool also takes the common inputs.
| Field | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Default: 10 |
| cursor | string | No | nextCursor of the previous call; keep the other arguments unchanged. |
| changedAt | object | No | Inclusive. 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. | string | No | |
| changedAt. | string | No | |
| ids | string[] | No | Actions 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. |
| userIds | string[] | No | Actions by these users. Resolve via distru-search-users. |
| sources | enum[]16 valuesAI_AGENTAUTOMATIONBIOTRACKIMPORTJOBLEGACYMCPMETRCMIGRATIONMOBILEPARTNER_APIPUBLIC_APIQUICKBOOKSSTAFF_SQLUNKNOWNWEB | No | |
| ops | enum[]DELETEINSERTUPDATE | No | Actions that created (INSERT), updated or deleted a record of a type shown. |
| recordTypes | enum[]47 valuesASSEMBLYAUTOMATIONBATCHBINCHARGE_PRESETCOMPANYCOMPANY_GROUPCOMPLIANCE_TRANSFERCOST_TYPECREDITCUSTOM_VALIDATIONDATASETDRIVERHARVESTINVITATIONINVOICELABEL_TEMPLATEMENUSALES_ORDERORDER_SHIPMENTPACKAGEPAYMENT_METHODPAYMENT_TERMPLANTPLANT_ADDITIVEPLANT_ADDITIVE_TYPEPLANT_GROUPPLANT_WASTEPRICE_TIERPRODUCTPRODUCT_CATEGORYPRODUCT_GROUPPURCHASERELATIONSHIP_TYPERETURNROLESCHEDULED_ALERTSTOCK_TRANSFERSTRAINTAGTAXTEAMTEARDOWNTEST_RESULTUNIT_TYPEUSERVEHICLE | No | Actions on records of these types; records and recordCounts hold only these types. |
| sortBy | object | No | Default CHANGED_AT DESC, newest first. |
| sortBy. | enumASCDESC | Yes | |
| sortBy. | enumCHANGED_AT | Yes | CHANGED_AT: when the action started, or the note was logged. |
Output
Presence on a nested field assumes its parent exists.
| Field | Type | Presence | Description |
|---|---|---|---|
| hasMore | boolean | Always | |
| nextCursor | string | Can be absent | |
| totalCount | integer | Can be absent | |
| items | object[] | Always | |
| items[]. | string | Always | |
| items[]. | string | Always | |
| items[]. | object | Can be null | Null for syncs and jobs. |
| items[]. | string | Can be null | Null for Distru Support and another company's user, whose id no tool takes. |
| items[]. | string | Always | |
| items[]. | string | Can be null | The actor's company, when it isn't the record's (a buyer's user). |
| items[]. | object | Can be null | Distru staff acting for the actor, as Distru Support. |
| items[]. | string | Can be null | Null for Distru Support and another company's user, whose id no tool takes. |
| items[]. | string | Always | |
| items[]. | string | Can be null | The actor's company, when it isn't the record's (a buyer's user). |
| items[]. | enum16 valuesAI_AGENTAUTOMATIONBIOTRACKIMPORTJOBLEGACYMCPMETRCMIGRATIONMOBILEPARTNER_APIPUBLIC_APIQUICKBOOKSSTAFF_SQLUNKNOWNWEB | Always | |
| items[]. | string | Can be null | The API key or automation name; Distru Support for a fix by Distru staff. |
| items[]. | integer | Always | |
| items[]. | boolean | Always | |
| items[]. | object[] | Always | Every record of the entry by type, including those past the 50-row cap on records. |
| items[]. | enum128 valuesACCOUNTASSEMBLYASSEMBLY_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[]. | integer | Always | |
| items[]. | object[] | Always | |
| items[]. | enum128 valuesACCOUNTASSEMBLYASSEMBLY_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 null | Null for rows whose record is gone. |
| items[]. | string | Can be absent | Left out when the MCP takes that type's ids nowhere; QuickBooks ids are raw. |
| items[]. | string | Can be null | The record's current name (its last one once deleted), not its name then. |
| items[]. | enumDELETEINSERTUPDATE | Always | INSERT or DELETE when the action created or deleted the record itself; a change to its lines alone is an UPDATE. |
| items[]. | string[] | Always | |
| items[]. | integer | Always | |
| items[]. | boolean | Always |
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.