{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Filter presets and scheduled exports","description":"Guides and API reference for the DataSift (REISift) Core API and SiftMap API."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"filter-presets-and-scheduled-exports","__idx":0},"children":["Filter presets and scheduled exports"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter presets are saved record filters: the building blocks of a repeatable marketing system. A preset captures a query over your records (lists, tags, statuses, counters, custom fields); folders organize presets into a funnel; scheduled exports turn a preset into a recurring data feed without any polling code."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preset-crud","__idx":1},"children":["Preset CRUD"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List presets"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a preset"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detail (includes the stored filter definition)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PUT / PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/compile/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Compile a filter definition (validate and resolve it server side)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Preset folders follow the standard folder pattern at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset-folder/"]},", with nested preset management at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset-folder/{folder_uuid}/filter-preset/..."]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-compile-endpoint","__idx":2},"children":["The compile endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/internal/filter-preset/compile/"]}," takes a filter definition and returns the compiled form the platform will execute. Use it as a pre-flight check when building presets programmatically: compile first, inspect what resolved, then create the preset. This catches misspelled tag names and malformed clauses before they become a silently empty preset."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"building-a-preset-programmatically","__idx":3},"children":["Building a preset programmatically"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The reliable pattern for constructing filter definitions in code:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Build one preset by hand in the app the way you want it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," that preset by uuid and study the stored filter definition."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Template it: swap the tag and list uuids for your targets."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/internal/filter-preset/compile/"]}," to validate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create the preset, then ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," it back and diff against your intent."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This read-one-then-template approach survives platform filter-language evolution far better than hand-writing filter JSON from scratch."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"scheduled-exports","__idx":4},"children":["Scheduled exports"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each preset can carry one scheduled export: the platform runs the preset on a schedule and produces an export artifact."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{filter_preset_uuid}/scheduled-export/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read the schedule"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{filter_preset_uuid}/scheduled-export/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{filter_preset_uuid}/scheduled-export/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/filter-preset/{filter_preset_uuid}/scheduled-export/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove it"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Scheduled exports replace \"cron job that hits the list endpoint every morning\" for most feed use cases: define the preset, schedule the export, and pick up the artifact. Verify the first artifact manually before trusting the schedule (row count and a spot check of columns), and re-verify after any preset edit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"funnel-design-with-preset-folders","__idx":5},"children":["Funnel design with preset folders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A production marketing funnel is a folder of presets in stage order, where each preset both selects the current stage and excludes everything later:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Folder: Niche Sequential - Foreclosure\n  01 Ready to Skip Trace   (on list, not tagged 01+)\n  02 Ready to Call         (tagged 01, has phones, not tagged 02+)\n  03 Ready for Mail        (tagged 02, call attempts >= N, not tagged 03+)\n  04 Deep Prospect         (exhausted 01-03, no contact)\n  Suppression - Done or Dead  (terminal tags; excluded by every stage above)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Records flow down as tags accumulate: work stage 02, tag records ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["02"]},", and they drop from preset 02 into preset 03's scope automatically. The suppression preset is the mirror image that every stage excludes. Verification for a funnel build: every stage preset compiles, the stage counts sum to no more than the source list count, and no record appears in two stages (spot-check a few uuids)."]}]},"headings":[{"value":"Filter presets and scheduled exports","id":"filter-presets-and-scheduled-exports","depth":1},{"value":"Preset CRUD","id":"preset-crud","depth":2},{"value":"The compile endpoint","id":"the-compile-endpoint","depth":2},{"value":"Building a preset programmatically","id":"building-a-preset-programmatically","depth":2},{"value":"Scheduled exports","id":"scheduled-exports","depth":2},{"value":"Funnel design with preset folders","id":"funnel-design-with-preset-folders","depth":2}],"frontmatter":{"seo":{"title":"Filter presets and scheduled exports"}},"lastModified":"2026-10-29T16:09:58.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/filter-presets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}