{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Tags, lists, and folders","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":"tags-lists-and-folders","__idx":0},"children":["Tags, lists, and folders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tags and lists are the two labeling systems on property records. Lists represent where a record CAME FROM (the source list you imported); tags represent what you KNOW or have DONE (motivation markers, workflow states, suppression flags). Both organize into folders. Everything here is account-wide configuration; applying them to records happens through the property actions in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/properties"},"children":["Properties"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tags","__idx":1},"children":["Tags"]},{"$$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/tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List tags"]}]},{"$$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/tag/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a tag"]}]},{"$$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/tag/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tag detail"]}]},{"$$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/tag/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rename or edit"]}]},{"$$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/tag/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete (confirm before destructive ops)"]}]},{"$$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/tag/{uuid}/properties-count/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Records carrying this tag"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tag folders: same CRUD pattern at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/tag-folder/"]},", plus nested tag management at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/tag-folder/{folder_uuid}/tag/..."]}," so you can create a tag directly inside a folder."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lists","__idx":2},"children":["Lists"]},{"$$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/list/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List lists"]}]},{"$$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/list/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a list"]}]},{"$$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/list/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detail"]}]},{"$$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/list/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Edit"]}]},{"$$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/list/{uuid}/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete"]}]},{"$$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/list/{uuid}/properties-count/"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Records on this list"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List folders mirror tag folders at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/internal/list-folder/"]}," with nested list management."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-counts-are-your-instrumentation","__idx":3},"children":["The counts are your instrumentation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["properties-count"]}," on tags, lists, and phone tags is the cheapest verification and reporting primitive in the platform. Use it to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify bulk operations (tag 2,000 records, then confirm the count moved by 2,000)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor funnel stages (each stage tag's count is a live pipeline metric)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Detect drift (a suppression tag whose count stops growing means the suppression job broke)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"naming-discipline","__idx":4},"children":["Naming discipline"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A naming convention keeps an account navigable once tags reach the hundreds:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prefix by system: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FTM - "]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bulk - "]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone - "]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Supp - "]}," and group each prefix into its folder."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use plain ASCII hyphens in names; the platform strips em dashes from titles."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Encode stage order in names where sequencing matters (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01 Skip Trace"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["02 Calling"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["03 Mail"]},"), so alphabetical order matches funnel order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One meaning per tag. When a tag means two things, split it; filters and counts stay trustworthy."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"worked-example---create-a-folder-with-staged-tags","__idx":5},"children":["Worked example - create a folder with staged tags"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"python","header":{"controls":{"copy":{}}},"source":"import os, requests\nBASE = \"https://apiv2.reisift.io\"\nH = {\"Authorization\": f\"Api-Key {os.environ['DATASIFT_API_KEY']}\",\n     \"Content-Type\": \"application/json\"}\n\nfolder = requests.post(f\"{BASE}/api/internal/tag-folder/\", headers=H,\n                       json={\"title\": \"Marketing Stages\"}, timeout=30).json()\n\nfor name in [\"01 Skip Traced\", \"02 Calling\", \"03 Mail Sent\", \"04 Deep Prospect\", \"Done - Dead\"]:\n    requests.post(f\"{BASE}/api/internal/tag-folder/{folder['uuid']}/tag/\",\n                  headers=H, json={\"title\": name}, timeout=30).raise_for_status()\n\n# Verify: read the folder's tags back and check all five exist\ntags = requests.get(f\"{BASE}/api/internal/tag-folder/{folder['uuid']}/tag/\",\n                    headers=H, timeout=30).json()\n","lang":"python"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tags and lists take a short payload: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]}," (required) and optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folder_uuid"]},". Folders take just a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"global-statuses","__idx":6},"children":["Global statuses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Statuses are the one-per-record pipeline state (New Lead, Not Interested, Return Mail, and so on), managed at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/internal/global-status/"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},"/",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH"]}," per status. Statuses are account-wide and finite; use tags for anything that can co-exist, and status for the single current state."]}]},"headings":[{"value":"Tags, lists, and folders","id":"tags-lists-and-folders","depth":1},{"value":"Tags","id":"tags","depth":2},{"value":"Lists","id":"lists","depth":2},{"value":"The counts are your instrumentation","id":"the-counts-are-your-instrumentation","depth":2},{"value":"Naming discipline","id":"naming-discipline","depth":2},{"value":"Worked example - create a folder with staged tags","id":"worked-example---create-a-folder-with-staged-tags","depth":2},{"value":"Global statuses","id":"global-statuses","depth":2}],"frontmatter":{"seo":{"title":"Tags, lists, and folders"}},"lastModified":"2026-10-29T17:19:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/tags-lists-folders","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}