Adds everyone the given UPNs or emails match, all with the same reason,
exactly as adding people from TOTAL’s watchlist page does. One bad
identifier never blocks the rest: each comes back in not_found or
ignored. Anyone already watched is reported and left as they are.
UPNs or emails separated by commas, semicolons, spaces or new lines, up to 50,000. Matched whole and without regard to case, against each user's UPN and email addresses.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TruU Docs","colors":{"primary":"#101010","light":"#faa536","dark":"#faa536"},"logo":{"light":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a","dark":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229931.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=0bfe1c1c8b293387d07ea4145aa57b74"},"favicon":"https://mintcdn.com/truu-2/29VTyTZfF-4PId_r/d332cdf-learn-more.svg?fit=max\u0026auto=format\u0026n=29VTyTZfF-4PId_r\u0026q=85\u0026s=24c4a71a0ed524868233103635f73373","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://www.truu.ai/","label":"TruU Website"},{"href":"https://www.truu.ai/contact","label":"Support"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/truu-security","website":"https://www.truu.ai/"}},"fonts":{"family":"Inter"},"interaction":{"drilldown":true},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"truu-2","hasAudioNarration":false,"actualSubdomain":"truu-2","customDomains":["docs.truu.ai"],"gitSource":{"type":"github","owner":"truudocs","repo":"mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae2308dfdcdc020a5fc9e32","collectionId":"fccc7e69-a0cd-42d8-b2c2-e48b15a407b7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae2308dfdcdc020a5fc9e32"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae2308dfdcdc020a5fc9e32","clientVersion":"0.0.4005","searchFilterCounts":[{"language":"default","tag":"Passwordless","count":296},{"language":"default","tag":"Setup","count":130},{"language":"default","tag":"Release Notes","count":90},{"language":"default","tag":"User Guides","count":72},{"language":"default","tag":"TOTAL","count":69},{"language":"default","tag":"Platform","count":68},{"language":"default","tag":"FAQ","count":40},{"language":"default","tag":"FAQ: Knowledge Base","count":40},{"language":"default","tag":"Getting Started","count":38},{"language":"default","tag":"Windows","count":36}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"sa@truu.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/watchlist/put-people-on-the-watchlist","slug":"/api-reference/watchlist/put-people-on-the-watchlist","pageMetadata":{"title":"Put people on the watchlist","description":"Adds everyone the given UPNs or emails match, all with the same reason,\nexactly as adding people from TOTAL's watchlist page does. One bad\nidentifier never blocks the rest: each comes back in `not_found` or\n`ignored`. Anyone already watched is reported and left as they are.\n","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs post /watchlist","href":"/api-reference/watchlist/put-people-on-the-watchlist","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Adds everyone the given UPNs or emails match, all with the same reason,\\nexactly as adding people from TOTAL’s watchlist page does. One bad\\nidentifier never blocks the rest: each comes back in \", _jsx(_components.code, {\n children: \"not_found\"\n }), \" or\\n\", _jsx(_components.code, {\n children: \"ignored\"\n }), \". Anyone already watched is reported and left as they are.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Put people on the watchlist","description":"Adds everyone the given UPNs or emails match, all with the same reason,\nexactly as adding people from TOTAL's watchlist page does. One bad\nidentifier never blocks the rest: each comes back in `not_found` or\n`ignored`. Anyone already watched is reported and left as they are.\n","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs post /watchlist","href":"/api-reference/watchlist/put-people-on-the-watchlist","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"addToWatchlist","summary":"Put people on the watchlist","description":"Adds everyone the given UPNs or emails match, all with the same reason,\nexactly as adding people from TOTAL's watchlist page does. One bad\nidentifier never blocks the rest: each comes back in `not_found` or\n`ignored`. Anyone already watched is reported and left as they are.\n","tags":["Watchlist"],"requestBody":"bb8d8a2f-c48a-4c65-931f-22c5ee3ea320","responses":{"200":"642feaf3-81f6-420b-8bb8-2990946b3a22","400":"af8b62be-8dff-4a81-81e8-71c2211b2c66","401":"b2afd097-46f1-4dfe-a3f8-9277a1c4e956","403":"0dd0c40e-059f-4fbb-8762-6390c78e9e7a","422":"ba92bc5c-8abf-463a-b301-e9b6032d4381","423":"cee4d7ad-b580-4ddd-8fda-96706712f0b9","429":"d0a4ab1a-a4ef-42d0-9bf4-5707799dc034"},"method":"post","type":"path","servers":["28a6c6a2-38d1-4109-b782-fc2a514d4a71"],"security":["e6c373b2-2574-4697-9ac7-7dfb3d1c6411"],"path":"/watchlist","baseUrlOptions":["https://eris.platform.total.truu.ai/api/v1/external"],"title":"Put people on the watchlist","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["upns","reason"],"properties":{"upns":{"type":"string","description":"UPNs or emails separated by commas, semicolons, spaces or new lines, up to 50,000. Matched whole and without regard to case, against each user's UPN and email addresses.\n","isRequired":true,"uniqueKey":"upns","typeLabel":"string"},"reason":{"type":"string","minLength":1,"description":"Why these people are watched. Every entry gets the same reason.","isRequired":true,"uniqueKey":"reason","typeLabel":"string"},"expires_at":{"type":"string","format":"date-time","description":"When the entries come off the watchlist; must be in the future. Defaults to 90 days.","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"upns":"\u003cstring>","reason":"\u003cstring>","expires_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"642feaf3-81f6-420b-8bb8-2990946b3a22":{"description":"Who was added and who was not","content":{"application/json":{"schema":{"type":"object","properties":{"added":{"type":"array","items":{"type":"object","properties":{"identifier":{"type":"string","description":"The UPN or email you sent that matched this person.","uniqueKey":"added.items.[INDEX].identifier","typeLabel":"string"},"tuid":{"type":"string","format":"uuid","uniqueKey":"added.items.[INDEX].tuid","typeLabel":"string\u003cuuid>"}},"uniqueKey":"added.items.[INDEX]","typeLabel":"object"},"uniqueKey":"added","typeLabel":"object[]"},"already_on_watchlist":{"type":"array","description":"People already watched. Their entries are left as they are.","items":{"type":"object","properties":{"identifier":{"type":"string","description":"The UPN or email you sent that matched this person.","uniqueKey":"already_on_watchlist.items.[INDEX].identifier","typeLabel":"string"},"tuid":{"type":"string","format":"uuid","uniqueKey":"already_on_watchlist.items.[INDEX].tuid","typeLabel":"string\u003cuuid>"}},"uniqueKey":"already_on_watchlist.items.[INDEX]","typeLabel":"object"},"uniqueKey":"already_on_watchlist","typeLabel":"object[]"},"not_tracked":{"type":"array","description":"Added, but inactive or not tracked, so TOTAL's daily review never ranks them and being watched gives them no priority.\n","items":{"type":"object","properties":{"identifier":{"type":"string","description":"The UPN or email you sent that matched this person.","uniqueKey":"not_tracked.items.[INDEX].identifier","typeLabel":"string"},"tuid":{"type":"string","format":"uuid","uniqueKey":"not_tracked.items.[INDEX].tuid","typeLabel":"string\u003cuuid>"}},"uniqueKey":"not_tracked.items.[INDEX]","typeLabel":"object"},"uniqueKey":"not_tracked","typeLabel":"object[]"},"not_found":{"type":"array","description":"UPNs or emails that matched nobody.","items":{"type":"string","uniqueKey":"not_found.items.[INDEX]","typeLabel":"string"},"uniqueKey":"not_found","typeLabel":"string[]"},"ignored":{"type":"array","description":"Words that are not UPNs or emails (no `@`).","items":{"type":"string","uniqueKey":"ignored.items.[INDEX]","typeLabel":"string"},"uniqueKey":"ignored","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"added":[{"identifier":"\u003cstring>","tuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}],"already_on_watchlist":[{"identifier":"\u003cstring>","tuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}],"not_tracked":[{"identifier":"\u003cstring>","tuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}],"not_found":["\u003cstring>"],"ignored":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"af8b62be-8dff-4a81-81e8-71c2211b2c66":{"description":"No UPNs or emails in `upns`, more than 50,000, or `expires_at` not in the future","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","description":"422 only: where the body is invalid and why. Never echoes the values sent.","items":{"type":"object","properties":{"loc":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"details.items.[INDEX].loc.items.[INDEX]","typeLabel":"any"},"uniqueKey":"details.items.[INDEX].loc","typeLabel":"any[]"},"msg":{"type":"string","uniqueKey":"details.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","uniqueKey":"details.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"},"request_id":{"type":"string","description":"500 only: quote to support.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":[{"loc":["\u003cunknown>"],"msg":"\u003cstring>","type":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"b2afd097-46f1-4dfe-a3f8-9277a1c4e956":{"description":"Invalid or missing API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","description":"422 only: where the body is invalid and why. Never echoes the values sent.","items":{"type":"object","properties":{"loc":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"details.items.[INDEX].loc.items.[INDEX]","typeLabel":"any"},"uniqueKey":"details.items.[INDEX].loc","typeLabel":"any[]"},"msg":{"type":"string","uniqueKey":"details.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","uniqueKey":"details.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"},"request_id":{"type":"string","description":"500 only: quote to support.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":[{"loc":["\u003cunknown>"],"msg":"\u003cstring>","type":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"0dd0c40e-059f-4fbb-8762-6390c78e9e7a":{"description":"Insufficient scope — watchlist:write required","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","description":"422 only: where the body is invalid and why. Never echoes the values sent.","items":{"type":"object","properties":{"loc":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"details.items.[INDEX].loc.items.[INDEX]","typeLabel":"any"},"uniqueKey":"details.items.[INDEX].loc","typeLabel":"any[]"},"msg":{"type":"string","uniqueKey":"details.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","uniqueKey":"details.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"},"request_id":{"type":"string","description":"500 only: quote to support.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":[{"loc":["\u003cunknown>"],"msg":"\u003cstring>","type":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"ba92bc5c-8abf-463a-b301-e9b6032d4381":{"description":"Request body validation failed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","description":"422 only: where the body is invalid and why. Never echoes the values sent.","items":{"type":"object","properties":{"loc":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"details.items.[INDEX].loc.items.[INDEX]","typeLabel":"any"},"uniqueKey":"details.items.[INDEX].loc","typeLabel":"any[]"},"msg":{"type":"string","uniqueKey":"details.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","uniqueKey":"details.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"},"request_id":{"type":"string","description":"500 only: quote to support.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":[{"loc":["\u003cunknown>"],"msg":"\u003cstring>","type":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cee4d7ad-b580-4ddd-8fda-96706712f0b9":{"description":"Resource not ready yet for this domain","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Always `not_available`","uniqueKey":"error","typeLabel":"string"},"resource":{"type":"string","description":"One of `cases`, `threats`, `users`, `watchlist`, `personas`, `nhi`, `nhi-clusters`","uniqueKey":"resource","typeLabel":"string"},"message":{"type":"string","description":"Human-readable readiness status message","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","resource":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"d0a4ab1a-a4ef-42d0-9bf4-5707799dc034":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"},"details":{"type":"array","description":"422 only: where the body is invalid and why. Never echoes the values sent.","items":{"type":"object","properties":{"loc":{"type":"array","items":{"oneOf":[{}],"uniqueKey":"details.items.[INDEX].loc.items.[INDEX]","typeLabel":"any"},"uniqueKey":"details.items.[INDEX].loc","typeLabel":"any[]"},"msg":{"type":"string","uniqueKey":"details.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","uniqueKey":"details.items.[INDEX].type","typeLabel":"string"}},"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"details","typeLabel":"object[]"},"request_id":{"type":"string","description":"500 only: quote to support.","uniqueKey":"request_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","details":[{"loc":["\u003cunknown>"],"msg":"\u003cstring>","type":"\u003cstring>"}],"request_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e6c373b2-2574-4697-9ac7-7dfb3d1c6411":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Domain-scoped API key. Generate and manage keys from the API Keys\npage in Settings.\n\nAccepted in two forms:\n- `X-API-Key: \u003ckey>` header (preferred)\n- `Authorization: Bearer \u003ckey>` header (also accepted)\n","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"28a6c6a2-38d1-4109-b782-fc2a514d4a71":{"url":"https://eris.platform.total.truu.ai/api/v1/external","description":"TOTAL Public API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Domain-scoped API key. Generate and manage keys from the API Keys\npage in Settings.\n\nAccepted in two forms:\n- `X-API-Key: \u003ckey>` header (preferred)\n- `Authorization: Bearer \u003ckey>` header (also accepted)\n","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Domain-scoped API key. Generate and manage keys from the API Keys\npage in Settings.\n\nAccepted in two forms:\n- `X-API-Key: \u003ckey>` header (preferred)\n- `Authorization: Bearer \u003ckey>` header (also accepted)\n","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://eris.platform.total.truu.ai/api/v1/external/docs"},"subdomain":"truu-2","siteName":"TruU Docs","title":"Put people on the watchlist - TruU Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T17:28:10.731Z","originalFileLocation":"api-reference/watchlist/put-people-on-the-watchlist.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Adds everyone the given UPNs or emails match, all with the same reason, exactly as adding people from TOTAL\u0026#x27;s watchlist page does. One bad identifier never blocks the rest: each comes back in not_found or ignored. Anyone already watched is reported and left as they are.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Put people on the watchlist - TruU Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Adds everyone the given UPNs or emails match, all with the same reason, exactly as adding people from TOTAL\u0026#x27;s watchlist page does. One bad identifier never blocks the rest: each comes back in not_found or ignored. Anyone already watched is reported and left as they are.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TruU Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://truu-2.mintlify.app/_mintlify/api/og/v2?division=Watchlist\u0026amp;title=Put+people+on+the+watchlist\u0026amp;description=Adds+everyone+the+given+UPNs+or+emails+match%2C+all+with+the+same+reason%2C%0Aexactly+as+adding+people+from+TOTAL%27s+watchlist+page+does.+One+bad%0Aidentifier+never+bloc\u0026amp;theme=791ae1733da0355f6a476664\u0026amp;signature=0602e73a0edb3d87e15c5c8537578432bcad31955def83ea02a1378134481b7a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Put people on the watchlist - TruU Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Adds everyone the given UPNs or emails match, all with the same reason, exactly as adding people from TOTAL\u0026#x27;s watchlist page does. One bad identifier never blocks the rest: each comes back in not_found or ignored. Anyone already watched is reported and left as they are.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://truu-2.mintlify.app/_mintlify/api/og/v2?division=Watchlist\u0026amp;title=Put+people+on+the+watchlist\u0026amp;description=Adds+everyone+the+given+UPNs+or+emails+match%2C+all+with+the+same+reason%2C%0Aexactly+as+adding+people+from+TOTAL%27s+watchlist+page+does.+One+bad%0Aidentifier+never+bloc\u0026amp;theme=791ae1733da0355f6a476664\u0026amp;signature=0602e73a0edb3d87e15c5c8537578432bcad31955def83ea02a1378134481b7a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#101010\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/watchlist/put-people-on-the-watchlist.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truu.ai/#organization\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truu.ai#website\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist#webpage\",\"url\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist\",\"name\":\"Put people on the watchlist\",\"description\":\"Adds everyone the given UPNs or emails match, all with the same reason, exactly as adding people from TOTAL's watchlist page does. One bad identifier never blocks the rest: each comes back in not_found or ignored. Anyone already watched is reported and left as they are.\",\"dateModified\":\"2026-10-28T17:28:10.731Z\",\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"TruU Docs\",\"item\":\"https://docs.truu.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Put people on the watchlist\",\"item\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist#apireference\",\"headline\":\"Put people on the watchlist\",\"name\":\"Put people on the watchlist\",\"description\":\"Adds everyone the given UPNs or emails match, all with the same reason, exactly as adding people from TOTAL's watchlist page does. One bad identifier never blocks the rest: each comes back in not_found or ignored. Anyone already watched is reported and left as they are.\",\"url\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truu.ai/api-reference/watchlist/put-people-on-the-watchlist#webpage\"},\"dateModified\":\"2026-10-28T17:28:10.731Z\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TruU Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TruU Docs","nav":{"global":null,"products":[{"product":"Passwordless","color":{"light":"#c86c0e","dark":"#c86c0e"},"pages":[{"title":"Passwordless","href":"/docs/welcome-to-truu"}]},{"product":"TOTAL","color":{"light":"#c6c6c6","dark":"#c6c6c6"},"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":"/quickstart"}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/adding-integrations-to-total"}]},{"tab":"API","groups":[{"group":"Cases","pages":[{"title":"List hydrated cases with threat events","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /cases","href":"/api-reference/cases/list-hydrated-cases-with-threat-events"},{"title":"Claim a case for investigation","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs post /cases/{case_id}/claim","href":"/api-reference/cases/claim-a-case-for-investigation"},{"title":"Submit a verdict for a case","description":"Feed back a verdict from an external workflow or SOC analyst.\n\nSupply a single **outcome** describing what happened to the case (see\n`VerdictOutcome`), with an optional **comment**. `SAFE`,\n`FALSE_POSITIVE` and `TRUE_POSITIVE` close the case, as TOTAL's Close\nbutton does, whether or not it was claimed first. `ESCALATED` claims it.\n","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs post /cases/{case_id}/verdict","href":"/api-reference/cases/submit-a-verdict-for-a-case"}]},{"group":"Watchlist","pages":[{"title":"Put people on the watchlist","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs post /watchlist","href":"/api-reference/watchlist/put-people-on-the-watchlist"}]},{"group":"Users","pages":[{"title":"List provisioned users","description":null,"deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /users","href":"/api-reference/users/list-provisioned-users"},{"title":"Get a single user","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /users/{tuid}","href":"/api-reference/users/get-a-single-user"},{"title":"List a user's cases","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /users/{tuid}/cases","href":"/api-reference/users/list-a-users-cases"}]},{"group":"Personas","pages":[{"title":"List persona overviews","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /personas","href":"/api-reference/personas/list-persona-overviews"},{"title":"Get persona overview for a user","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /personas/{tuid}","href":"/api-reference/personas/get-persona-overview-for-a-user"},{"title":"Get persona detail for a user","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /personas/{tuid}/detail","href":"/api-reference/personas/get-persona-detail-for-a-user"},{"title":"List a user's past persona overviews","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /personas/{tuid}/history","href":"/api-reference/personas/list-a-users-past-persona-overviews"}]},{"group":"Threats","pages":[{"title":"List threat events","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /threats","href":"/api-reference/threats/list-threat-events"}]},{"group":"NHI","pages":[{"title":"List NHI identities","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/personas","href":"/api-reference/nhi/list-nhi-identities"},{"title":"Get one NHI overview","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/personas/{nuid}","href":"/api-reference/nhi/get-one-nhi-overview"},{"title":"Get NHI persona detail","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/personas/{nuid}/detail","href":"/api-reference/nhi/get-nhi-persona-detail"},{"title":"List NHI clusters","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/clusters","href":"/api-reference/nhi/list-nhi-clusters"},{"title":"Get one NHI cluster","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/clusters/{cluster_id}","href":"/api-reference/nhi/get-one-nhi-cluster"},{"title":"List members of one NHI cluster","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/clusters/{cluster_id}/members","href":"/api-reference/nhi/list-members-of-one-nhi-cluster"},{"title":"Get NHI cluster access rollup","deprecated":null,"version":null,"openapi":"https://eris.platform.total.truu.ai/api/v1/external/docs get /nhi/clusters/{cluster_id}/access","href":"/api-reference/nhi/get-nhi-cluster-access-rollup"}]}]}]},{"product":"Identity Verification","hidden":true,"pages":[{"title":"Identity Verification","href":"/idv/introduction"}]}]},"title":"Put people on the watchlist - TruU Docs","buildId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","deploymentId":"dpl_48qhjNLiu9iJQQSZJz9Fa2ihBbPH","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rBlzXElK.js","utils-AjnlCZis.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-swvqTHUt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CG9fqVU0.js","snippetPresets-CQaUsst6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-DAdT3l54.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B1x8JMQI.js","shallow-D3oUTT8_.js","getApiPlaygroundDisplay-CXVJ98Sz.js","CodeSnippet-HbTSvyGs.js","CodeSnippets-DvgXFP0T.js","Page-C2raW8UD.js","getPastedJson-CfDE0eLj.js","icon-DBPqa2DN.js","MethodPill-86CHHFOO.js","DuplicateIcon-B5BXvyBd.js","createIcon-C_r05QJX.js","DynamicMarkdown-Cp6hhEk1.js","SectionHeading-RZjzOLoo.js","axios-vUo_bRtp.js","Markdown-B0YOyiNO.js","clsx-Q3eNRTcf.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-tb1XVL5i.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9O1lyZBL.js"]}