Body: uuids (person UUIDs, max 100) plus optional limit (top contacts
per target, default 25, max 100), sort_by, and order. results holds
one entry per input UUID, in order; each carries that target’s total and
its top contacts. Targets that are not found come back with empty items
rather than failing the whole batch. (include_items: false is accepted
but only useful on the company batch, where top_external_contacts
remains populated.)
POST
/
v1
/
persons
/
recommended-paths
/
batch
Bulk recommended relationship paths for up to 100 target persons.
When false (companies only), skip the expensive items[] recommended-paths list and return just top_external_contacts per company, which keeps large batches fast. Use this if you only consume top_external_contacts.
results holds one RecommendedPathsResponse per input UUID, in the same
order as the request. Targets that are not found come back with empty
items rather than failing the whole batch.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Rings AI","description":"Relationship intelligence for businesses that win on their networks. Build on Rings with the REST API or connect AI agents via MCP.","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec"},"favicon":{"light":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876","dark":"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/icon-original.png?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=968ab65ef5c4793a38135dd4d6868876"},"api":{"openapi":"https://production-api.joinrings.com/openapi.json"},"appearance":{"default":"dark"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://www.rings.ai","label":"Website"}],"primary":{"type":"button","label":"Get Started","href":"https://joinrings.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"schema":true},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"rings-ai","hasAudioNarration":false,"actualSubdomain":"rings-ai","customDomains":["docs.rings.ai"],"gitSource":{"type":"github","owner":"rings-ai","repo":"rcp-data-pipeline","deployBranch":"main","contentDirectory":"mintlify_docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"collectionId":"f2baa2ef-5f3c-4fb9-b645-454aa43e6c38","liveDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3521290bdcff7cbc3b51f"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae3521290bdcff7cbc3b51f","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":77},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Opportunity","count":11},{"language":"default","tag":"MCP Guide","count":11},{"language":"default","tag":"Add the connector","count":10},{"language":"default","tag":"Note","count":9},{"language":"default","tag":"Person","count":9},{"language":"default","tag":"Activity","count":8},{"language":"default","tag":"Company","count":7},{"language":"default","tag":"Task","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"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":"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":"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/recommended-paths/person-batch","slug":"/api-reference/recommended-paths/person-batch","pageMetadata":{"title":"Bulk recommended paths (persons)","openapi":"POST /v1/persons/recommended-paths/batch","description":"\nBody: `uuids` (person UUIDs, max 100) plus optional `limit` (top contacts\nper target, default 25, max 100), `sort_by`, and `order`. `results` holds\none entry per input UUID, in order; each carries that target's `total` and\nits top contacts. Targets that are not found come back with empty `items`\nrather than failing the whole batch. (`include_items: false` is accepted\nbut only useful on the company batch, where `top_external_contacts`\nremains populated.)","href":"/api-reference/recommended-paths/person-batch"},"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: [\"Body: \", _jsx(_components.code, {\n children: \"uuids\"\n }), \" (person UUIDs, max 100) plus optional \", _jsx(_components.code, {\n children: \"limit\"\n }), \" (top contacts\\nper target, default 25, max 100), \", _jsx(_components.code, {\n children: \"sort_by\"\n }), \", and \", _jsx(_components.code, {\n children: \"order\"\n }), \". \", _jsx(_components.code, {\n children: \"results\"\n }), \" holds\\none entry per input UUID, in order; each carries that target’s \", _jsx(_components.code, {\n children: \"total\"\n }), \" and\\nits top contacts. Targets that are not found come back with empty \", _jsx(_components.code, {\n children: \"items\"\n }), \"\\nrather than failing the whole batch. (\", _jsx(_components.code, {\n children: \"include_items: false\"\n }), \" is accepted\\nbut only useful on the company batch, where \", _jsx(_components.code, {\n children: \"top_external_contacts\"\n }), \"\\nremains populated.)\"]\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":"Bulk recommended paths (persons)","openapi":"POST /v1/persons/recommended-paths/batch","description":"\nBody: `uuids` (person UUIDs, max 100) plus optional `limit` (top contacts\nper target, default 25, max 100), `sort_by`, and `order`. `results` holds\none entry per input UUID, in order; each carries that target's `total` and\nits top contacts. Targets that are not found come back with empty `items`\nrather than failing the whole batch. (`include_items: false` is accepted\nbut only useful on the company batch, where `top_external_contacts`\nremains populated.)","href":"/api-reference/recommended-paths/person-batch"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"\nBody: `uuids` (person UUIDs, max 100) plus optional `limit` (top contacts\nper target, default 25, max 100), `sort_by`, and `order`. `results` holds\none entry per input UUID, in order; each carries that target's `total` and\nits top contacts. Targets that are not found come back with empty `items`\nrather than failing the whole batch. (`include_items: false` is accepted\nbut only useful on the company batch, where `top_external_contacts`\nremains populated.)","operationId":"post_bulk_person_recommended_paths","parameters":[],"requestBody":"66e85cb1-c935-48f3-bd3e-b9690e073e1e","responses":{"200":"6b25ae18-188f-4d86-a007-49866f642846"},"summary":"Bulk recommended relationship paths for up to 100 target persons.","tags":["Recommended Paths"],"method":"post","type":"path","servers":["ac0c72ea-24cd-42c5-bf7e-af9869eeb624"],"security":["d3e1b4d8-8e73-42d2-8242-48f05e417bca"],"path":"/v1/persons/recommended-paths/batch","baseUrlOptions":["https://production-api.joinrings.com"],"title":"Bulk recommended relationship paths for up to 100 target persons.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"uuids":{"items":{"type":"string","uniqueKey":"uuids.items.[INDEX]","typeLabel":"string"},"title":"Uuids","type":"array","isRequired":true,"uniqueKey":"uuids","typeLabel":"string[]"},"include_items":{"default":true,"description":"When false (companies only), skip the expensive `items[]` recommended-paths list and return just `top_external_contacts` per company, which keeps large batches fast. Use this if you only consume `top_external_contacts`.","title":"Include Items","type":"boolean","uniqueKey":"include_items","typeLabel":"boolean"},"limit":{"default":25,"description":"Max contacts returned per target (1-100).","title":"Limit","type":"integer","uniqueKey":"limit","typeLabel":"integer"},"order":{"default":"desc","description":"Sort order. Default: 'desc' (highest score first)","enum":["asc","desc"],"title":"Order","type":"string","uniqueKey":"order","typeLabel":"enum\u003cstring>"},"sort_by":{"oneOf":[{"type":"string","title":"Sort By","description":"Field to sort by. Valid values: 'score', 'name'","enum":["score","name"],"uniqueKey":"sort_by.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Sort By","description":"Field to sort by. Valid values: 'score', 'name'","uniqueKey":"sort_by.oneOf.1","typeLabel":"null"}],"uniqueKey":"sort_by","typeLabel":"enum\u003cstring> | null"}},"required":["uuids"],"title":"RecommendedPathsBatchRequest","type":"object","uniqueKey":"","typeLabel":"RecommendedPathsBatchRequest · object"},"examples":{"Example":{"title":"Example","value":{"uuids":["\u003cstring>"],"include_items":true,"limit":25,"order":"desc"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"6b25ae18-188f-4d86-a007-49866f642846":{"content":{"application/json":{"schema":{"properties":{"results":{"items":{"properties":{"items":{"items":{"properties":{"person_uuid":{"title":"Person Uuid","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].person_uuid","typeLabel":"string"},"company_name":{"oneOf":[{"type":"string","title":"Company Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].company_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].company_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].company_name","typeLabel":"string | null"},"connection_score":{"oneOf":[{"type":"integer","title":"Connection Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].connection_score.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Connection Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].connection_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].connection_score","typeLabel":"integer | null"},"email":{"oneOf":[{"type":"string","title":"Email","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].email","typeLabel":"string | null"},"emails":{"oneOf":[{"type":"array","items":{"properties":{"address":{"title":"Address","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX].address","typeLabel":"string"},"is_primary":{"default":false,"title":"Is Primary","type":"boolean","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX].is_primary","typeLabel":"boolean"},"last_seen_at":{"oneOf":[{"type":"string","title":"Last Seen At","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX].last_seen_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Seen At","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX].last_seen_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX].last_seen_at","typeLabel":"string | null"}},"required":["address"],"title":"ContactEmail","type":"object","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0.items.[INDEX]","typeLabel":"ContactEmail · object"},"title":"Emails","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.0","typeLabel":"ContactEmail · object[]"},{"type":"null","title":"Emails","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].emails","typeLabel":"ContactEmail · object[] | null"},"facebook_url":{"oneOf":[{"type":"string","title":"Facebook Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].facebook_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Facebook Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].facebook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].facebook_url","typeLabel":"string | null"},"is_internal":{"oneOf":[{"type":"boolean","title":"Is Internal","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_internal.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Internal","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_internal.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_internal","typeLabel":"boolean | null"},"is_primary_company_recommended":{"oneOf":[{"type":"boolean","title":"Is Primary Company Recommended","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_primary_company_recommended.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Is Primary Company Recommended","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_primary_company_recommended.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].is_primary_company_recommended","typeLabel":"boolean | null"},"job_title":{"oneOf":[{"type":"string","title":"Job Title","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].job_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Title","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].job_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].job_title","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].linkedin_url","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].logo_url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].name","typeLabel":"string | null"},"path_count":{"default":0,"title":"Path Count","type":"integer","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].path_count","typeLabel":"integer"},"paths":{"oneOf":[{"type":"array","items":{"items":{"properties":{"person_uuid":{"title":"Person Uuid","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].person_uuid","typeLabel":"string"},"associations":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].associations.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Associations","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].associations.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Associations","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].associations.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].associations","typeLabel":"string[] | null"},"company_name":{"oneOf":[{"type":"string","title":"Company Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].company_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Company Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].company_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].company_name","typeLabel":"string | null"},"connection_score":{"oneOf":[{"type":"integer","title":"Connection Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].connection_score.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Connection Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].connection_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].connection_score","typeLabel":"integer | null"},"interaction_count":{"oneOf":[{"type":"integer","title":"Interaction Count","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].interaction_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Interaction Count","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].interaction_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].interaction_count","typeLabel":"integer | null"},"job_title":{"oneOf":[{"type":"string","title":"Job Title","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].job_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Title","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].job_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].job_title","typeLabel":"string | null"},"last_interaction_at":{"oneOf":[{"type":"string","title":"Last Interaction At","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].last_interaction_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Interaction At","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].last_interaction_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].last_interaction_at","typeLabel":"string | null"},"linkedin_url":{"oneOf":[{"type":"string","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].linkedin_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Linkedin Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].linkedin_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].linkedin_url","typeLabel":"string | null"},"logo_url":{"oneOf":[{"type":"string","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].logo_url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].name","typeLabel":"string | null"},"ring_key":{"oneOf":[{"type":"string","title":"Ring Key","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_key.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ring Key","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_key.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_key","typeLabel":"string | null"},"ring_name":{"oneOf":[{"type":"string","title":"Ring Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Ring Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX].ring_name","typeLabel":"string | null"}},"required":["person_uuid"],"title":"PathHop","type":"object","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX].items.[INDEX]","typeLabel":"PathHop · object"},"type":"array","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0.items.[INDEX]","typeLabel":"PathHop · object[]"},"title":"Paths","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.0","typeLabel":"PathHop · object[][]"},{"type":"null","title":"Paths","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].paths","typeLabel":"PathHop · object[][] | null"},"primary_company":{"oneOf":[{"type":"object","title":"PrimaryCompany","properties":{"logo_url":{"oneOf":[{"type":"string","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.logo_url","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.name","typeLabel":"string | null"},"uuid":{"oneOf":[{"type":"string","title":"Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0.uuid","typeLabel":"string | null"}},"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.0","typeLabel":"PrimaryCompany · object"},{"type":"null","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].primary_company","typeLabel":"PrimaryCompany · object | null"},"priority_management":{"oneOf":[{"type":"array","items":{"properties":{"interaction_count":{"oneOf":[{"type":"integer","title":"Interaction Count","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].interaction_count.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Interaction Count","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].interaction_count.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].interaction_count","typeLabel":"integer | null"},"last_activity_date":{"oneOf":[{"type":"string","title":"Last Activity Date","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].last_activity_date.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Activity Date","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].last_activity_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].last_activity_date","typeLabel":"string | null"},"person_uuid":{"oneOf":[{"type":"string","title":"Person Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].person_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Person Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].person_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].person_uuid","typeLabel":"string | null"},"priority_context":{"oneOf":[{"type":"array","items":{"additionalProperties":true,"type":"object","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_context.oneOf.0.items.[INDEX]","typeLabel":"object"},"title":"Priority Context","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_context.oneOf.0","typeLabel":"Priority Context · object[]"},{"type":"null","title":"Priority Context","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_context.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_context","typeLabel":"Priority Context · object[] | null"},"priority_score":{"oneOf":[{"type":"number","title":"Priority Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Priority Score","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].priority_score","typeLabel":"number | null"},"rq":{"oneOf":[{"type":"number","title":"Rq","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq.oneOf.0","typeLabel":"number"},{"type":"null","title":"Rq","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq","typeLabel":"number | null"},"rq_manual":{"oneOf":[{"type":"number","title":"Rq Manual","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_manual.oneOf.0","typeLabel":"number"},{"type":"null","title":"Rq Manual","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_manual.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_manual","typeLabel":"number | null"},"rq_pretty":{"oneOf":[{"type":"number","title":"Rq Pretty","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_pretty.oneOf.0","typeLabel":"number"},{"type":"null","title":"Rq Pretty","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_pretty.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_pretty","typeLabel":"number | null"},"rq_reason":{"oneOf":[{"type":"string","title":"Rq Reason","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_reason.oneOf.0","typeLabel":"string"},{"type":"null","title":"Rq Reason","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].rq_reason","typeLabel":"string | null"},"signal_metadata":{"oneOf":[{"type":"object","title":"SignalMetadata","properties":{"associations":{"default":0,"title":"Associations","type":"integer","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].signal_metadata.oneOf.0.associations","typeLabel":"integer"},"lists":{"default":0,"title":"Lists","type":"integer","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].signal_metadata.oneOf.0.lists","typeLabel":"integer"}},"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].signal_metadata.oneOf.0","typeLabel":"SignalMetadata · object"},{"type":"null","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].signal_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].signal_metadata","typeLabel":"SignalMetadata · object | null"},"user_logo_url":{"oneOf":[{"type":"string","title":"User Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Logo Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_logo_url","typeLabel":"string | null"},"user_name":{"oneOf":[{"type":"string","title":"User Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Name","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_name","typeLabel":"string | null"},"user_uuid":{"oneOf":[{"type":"string","title":"User Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"User Uuid","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX].user_uuid","typeLabel":"string | null"}},"title":"PrioritySignal","type":"object","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0.items.[INDEX]","typeLabel":"PrioritySignal · object"},"title":"Priority Management","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.0","typeLabel":"PrioritySignal · object[]"},{"type":"null","title":"Priority Management","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].priority_management","typeLabel":"PrioritySignal · object[] | null"},"signal_metadata":{"oneOf":[{"type":"object","title":"SignalMetadata","properties":{"associations":{"default":0,"title":"Associations","type":"integer","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].signal_metadata.oneOf.0.associations","typeLabel":"integer"},"lists":{"default":0,"title":"Lists","type":"integer","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].signal_metadata.oneOf.0.lists","typeLabel":"integer"}},"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].signal_metadata.oneOf.0","typeLabel":"SignalMetadata · object"},{"type":"null","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].signal_metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].signal_metadata","typeLabel":"SignalMetadata · object | null"},"strength":{"oneOf":[{"type":"string","title":"Strength","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].strength.oneOf.0","typeLabel":"string"},{"type":"null","title":"Strength","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].strength.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].strength","typeLabel":"string | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Tags","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Tags","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].tags","typeLabel":"string[] | null"},"twitter_url":{"oneOf":[{"type":"string","title":"Twitter Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].twitter_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Twitter Url","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].twitter_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].\\items.items.[INDEX].twitter_url","typeLabel":"string | null"}},"required":["person_uuid"],"title":"RecommendedContact","type":"object","uniqueKey":"results.items.[INDEX].\\items.items.[INDEX]","typeLabel":"RecommendedContact · object"},"title":"Items","type":"array","isRequired":true,"uniqueKey":"results.items.[INDEX].\\items","typeLabel":"RecommendedContact · object[]"},"page":{"title":"Page","type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].page","typeLabel":"integer"},"per_page":{"title":"Per Page","type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].per_page","typeLabel":"integer"},"total":{"oneOf":[{"type":"integer","title":"Total","isRequired":true,"uniqueKey":"results.items.[INDEX].total.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Total","isRequired":true,"uniqueKey":"results.items.[INDEX].total.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].total","typeLabel":"integer | null"},"has_more":{"oneOf":[{"type":"boolean","title":"Has More","uniqueKey":"results.items.[INDEX].has_more.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Has More","uniqueKey":"results.items.[INDEX].has_more.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].has_more","typeLabel":"boolean | null"},"next_cursor":{"oneOf":[{"type":"string","title":"Next Cursor","uniqueKey":"results.items.[INDEX].next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Cursor","uniqueKey":"results.items.[INDEX].next_cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].next_cursor","typeLabel":"string | null"},"target_logo_url":{"oneOf":[{"type":"string","title":"Target Logo Url","uniqueKey":"results.items.[INDEX].target_logo_url.oneOf.0","typeLabel":"string"},{"type":"null","title":"Target Logo Url","uniqueKey":"results.items.[INDEX].target_logo_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].target_logo_url","typeLabel":"string | null"},"target_name":{"oneOf":[{"type":"string","title":"Target Name","uniqueKey":"results.items.[INDEX].target_name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Target Name","uniqueKey":"results.items.[INDEX].target_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].target_name","typeLabel":"string | null"},"target_uuid":{"oneOf":[{"type":"string","title":"Target Uuid","uniqueKey":"results.items.[INDEX].target_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Target Uuid","uniqueKey":"results.items.[INDEX].target_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].target_uuid","typeLabel":"string | null"},"top_external_contacts":{"oneOf":[{"type":"array","items":{"properties":{"person_uuid":{"title":"Person Uuid","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].person_uuid","typeLabel":"string"},"connection_score":{"oneOf":[{"type":"integer","title":"Connection Score","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].connection_score.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Connection Score","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].connection_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].connection_score","typeLabel":"integer | null"},"email":{"oneOf":[{"type":"string","title":"Email","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","title":"Email","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].email","typeLabel":"string | null"},"internal_connectors":{"oneOf":[{"type":"array","items":{"properties":{"internal_user_person_uuid":{"oneOf":[{"type":"string","title":"Internal User Person Uuid","description":"Person UUID for the internal user, usable as the `{uuid}` path parameter on other person endpoints.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_person_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Internal User Person Uuid","description":"Person UUID for the internal user, usable as the `{uuid}` path parameter on other person endpoints.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_person_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_person_uuid","typeLabel":"string | null"},"internal_user_uuid":{"oneOf":[{"type":"string","title":"Internal User Uuid","description":"UUID of the internal ring member.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_uuid.oneOf.0","typeLabel":"string"},{"type":"null","title":"Internal User Uuid","description":"UUID of the internal ring member.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_uuid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].internal_user_uuid","typeLabel":"string | null"},"last_engaged_at":{"oneOf":[{"type":"string","title":"Last Engaged At","description":"ISO 8601 timestamp of the most recent all-time activity between this internal user and the subject entity. May lag the most recent activity by up to a refresh interval.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].last_engaged_at.oneOf.0","typeLabel":"string"},{"type":"null","title":"Last Engaged At","description":"ISO 8601 timestamp of the most recent all-time activity between this internal user and the subject entity. May lag the most recent activity by up to a refresh interval.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].last_engaged_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].last_engaged_at","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","description":"Display name of the internal user.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","description":"Display name of the internal user.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"path_power_score":{"oneOf":[{"type":"number","title":"Path Power Score","description":"Strength of the relationship, sourced from `priority_management.rq_pretty`. Higher is stronger. The existing `pathpower.score` field remains the preferred numeric score for the person/company itself; this field reflects the specific internal user's relationship.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].path_power_score.oneOf.0","typeLabel":"number"},{"type":"null","title":"Path Power Score","description":"Strength of the relationship, sourced from `priority_management.rq_pretty`. Higher is stronger. The existing `pathpower.score` field remains the preferred numeric score for the person/company itself; this field reflects the specific internal user's relationship.","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].path_power_score.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX].path_power_score","typeLabel":"number | null"}},"title":"StrongestRelationship","type":"object","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0.items.[INDEX]","typeLabel":"StrongestRelationship · object"},"title":"Internal Connectors","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.0","typeLabel":"StrongestRelationship · object[]"},{"type":"null","title":"Internal Connectors","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].internal_connectors","typeLabel":"StrongestRelationship · object[] | null"},"job_title":{"oneOf":[{"type":"string","title":"Job Title","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].job_title.oneOf.0","typeLabel":"string"},{"type":"null","title":"Job Title","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].job_title.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].job_title","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","title":"Name","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","title":"Name","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].name","typeLabel":"string | null"},"strength":{"oneOf":[{"type":"string","title":"Strength","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].strength.oneOf.0","typeLabel":"string"},{"type":"null","title":"Strength","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].strength.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].strength","typeLabel":"string | null"},"tags":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].tags.oneOf.0.items.[INDEX]","typeLabel":"string"},"title":"Tags","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].tags.oneOf.0","typeLabel":"string[]"},{"type":"null","title":"Tags","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX].tags","typeLabel":"string[] | null"}},"required":["person_uuid"],"title":"TopExternalContact","type":"object","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0.items.[INDEX]","typeLabel":"TopExternalContact · object"},"title":"Top External Contacts","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.0","typeLabel":"TopExternalContact · object[]"},{"type":"null","title":"Top External Contacts","uniqueKey":"results.items.[INDEX].top_external_contacts.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].top_external_contacts","typeLabel":"TopExternalContact · object[] | null"}},"required":["items","page","per_page","total"],"title":"RecommendedPathsResponse","type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"RecommendedPathsResponse · object"},"title":"Results","type":"array","isRequired":true,"uniqueKey":"results","typeLabel":"RecommendedPathsResponse · object[]"}},"required":["results"],"title":"RecommendedPathsBatchResponse","type":"object","uniqueKey":"","typeLabel":"RecommendedPathsBatchResponse · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"items":[{"person_uuid":"\u003cstring>","company_name":"\u003cstring>","connection_score":123,"email":"\u003cstring>","emails":[{"address":"\u003cstring>","is_primary":false,"last_seen_at":"\u003cstring>"}],"facebook_url":"\u003cstring>","is_internal":true,"is_primary_company_recommended":true,"job_title":"\u003cstring>","linkedin_url":"\u003cstring>","logo_url":"\u003cstring>","name":"\u003cstring>","path_count":0,"paths":[[{"person_uuid":"\u003cstring>","associations":["\u003cstring>"],"company_name":"\u003cstring>","connection_score":123,"interaction_count":123,"job_title":"\u003cstring>","last_interaction_at":"\u003cstring>","linkedin_url":"\u003cstring>","logo_url":"\u003cstring>","name":"\u003cstring>","ring_key":"\u003cstring>","ring_name":"\u003cstring>"}]],"primary_company":{"logo_url":"\u003cstring>","name":"\u003cstring>","uuid":"\u003cstring>"},"priority_management":[{"interaction_count":123,"last_activity_date":"\u003cstring>","person_uuid":"\u003cstring>","priority_context":[{}],"priority_score":123,"rq":123,"rq_manual":123,"rq_pretty":123,"rq_reason":"\u003cstring>","signal_metadata":{"associations":0,"lists":0},"user_logo_url":"\u003cstring>","user_name":"\u003cstring>","user_uuid":"\u003cstring>"}],"signal_metadata":{"associations":0,"lists":0},"strength":"\u003cstring>","tags":["\u003cstring>"],"twitter_url":"\u003cstring>"}],"page":123,"per_page":123,"total":123,"has_more":true,"next_cursor":"\u003cstring>","target_logo_url":"\u003cstring>","target_name":"\u003cstring>","target_uuid":"\u003cstring>","top_external_contacts":[{"person_uuid":"\u003cstring>","connection_score":123,"email":"\u003cstring>","internal_connectors":[{"internal_user_person_uuid":"\u003cstring>","internal_user_uuid":"\u003cstring>","last_engaged_at":"\u003cstring>","name":"\u003cstring>","path_power_score":123}],"job_title":"\u003cstring>","name":"\u003cstring>","strength":"\u003cstring>","tags":["\u003cstring>"]}]}]}}},"exampleType":"generated"}},"description":"Bulk recommended-paths response.\n\n`results` holds one `RecommendedPathsResponse` per input UUID, in the same\norder as the request. Targets that are not found come back with empty\n`items` rather than failing the whole batch.","exampleType":"generated"}},"security":{"d3e1b4d8-8e73-42d2-8242-48f05e417bca":{"ApiKeyAuth":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"ac0c72ea-24cd-42c5-bf7e-af9869eeb624":{"description":"API server","url":"https://production-api.joinrings.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"in":"header","name":"x-api-key","type":"apiKey","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://production-api.joinrings.com/openapi.json"},"subdomain":"rings-ai","siteName":"Rings AI","title":"Bulk recommended paths (persons) - Rings AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-17T10:17:51.917Z","originalFileLocation":"api-reference/recommended-paths/person-batch.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=\"Body: uuids (person UUIDs, max 100) plus optional limit (top contacts per target, default 25, max 100), sort_by, and order. results holds one entry per input UUID, in order; each carries that target\u0026#x27;s total and its top contacts. Targets that are not found come back with empty items rather than failing the whole batch. (include_items: false is accepted but only useful on the company batch, where top_external_contacts remains populated.)\">\u003cmeta data-mint-head name=\"application-name\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bulk recommended paths (persons) - Rings AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Body: uuids (person UUIDs, max 100) plus optional limit (top contacts per target, default 25, max 100), sort_by, and order. results holds one entry per input UUID, in order; each carries that target\u0026#x27;s total and its top contacts. Targets that are not found come back with empty items rather than failing the whole batch. (include_items: false is accepted but only useful on the company batch, where top_external_contacts remains populated.)\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Rings AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.rings.ai/api-reference/recommended-paths/person-batch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Recommended+Paths\u0026amp;title=Bulk+recommended+paths+%28persons%29\u0026amp;description=%0ABody%3A+%60uuids%60+%28person+UUIDs%2C+max+100%29+plus+optional+%60limit%60+%28top+contacts%0Aper+target%2C+default+25%2C+max+100%29%2C+%60sort_by%60%2C+and+%60order%60.+%60results%60+holds%0Aone+entry+p\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=6d359087e130859ef8a83958eecf0894cffcfb2a4d778a65d0def1861d3b8f6c\">\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=\"Bulk recommended paths (persons) - Rings AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Body: uuids (person UUIDs, max 100) plus optional limit (top contacts per target, default 25, max 100), sort_by, and order. results holds one entry per input UUID, in order; each carries that target\u0026#x27;s total and its top contacts. Targets that are not found come back with empty items rather than failing the whole batch. (include_items: false is accepted but only useful on the company batch, where top_external_contacts remains populated.)\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://rings-ai.mintlify.app/_mintlify/api/og/v2?division=Recommended+Paths\u0026amp;title=Bulk+recommended+paths+%28persons%29\u0026amp;description=%0ABody%3A+%60uuids%60+%28person+UUIDs%2C+max+100%29+plus+optional+%60limit%60+%28top+contacts%0Aper+target%2C+default+25%2C+max+100%29%2C+%60sort_by%60%2C+and+%60order%60.+%60results%60+holds%0Aone+entry+p\u0026amp;theme=2e1657476a2935937e03de5f\u0026amp;signature=6d359087e130859ef8a83958eecf0894cffcfb2a4d778a65d0def1861d3b8f6c\">\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/rings-ai/_zk5vOoQ8ix_XOCm/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Rings AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.rings.ai/api-reference/recommended-paths/person-batch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/recommended-paths/person-batch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.rings.ai/#organization\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/rings-ai/EVsJFZndjLtW_7WK/images/Group5.svg?fit=max\u0026auto=format\u0026n=EVsJFZndjLtW_7WK\u0026q=85\u0026s=bbbf7303b09ab9978ffaee9e90f250ec\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.rings.ai#website\",\"name\":\"Rings AI\",\"url\":\"https://docs.rings.ai\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch#webpage\",\"url\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch\",\"name\":\"Bulk recommended paths (persons)\",\"description\":\"Body: uuids (person UUIDs, max 100) plus optional limit (top contacts per target, default 25, max 100), sort_by, and order. results holds one entry per input UUID, in order; each carries that target's total and its top contacts. Targets that are not found come back with empty items rather than failing the whole batch. (include_items: false is accepted but only useful on the company batch, where top_external_contacts remains populated.)\",\"dateModified\":\"2026-07-17T10:17:51.917Z\",\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recommended Paths\",\"item\":\"https://docs.rings.ai/api-reference/recommended-paths/person\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bulk recommended paths (persons)\",\"item\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch#apireference\",\"headline\":\"Bulk recommended paths (persons)\",\"name\":\"Bulk recommended paths (persons)\",\"description\":\"Body: uuids (person UUIDs, max 100) plus optional limit (top contacts per target, default 25, max 100), sort_by, and order. results holds one entry per input UUID, in order; each carries that target's total and its top contacts. Targets that are not found come back with empty items rather than failing the whole batch. (include_items: false is accepted but only useful on the company batch, where top_external_contacts remains populated.)\",\"url\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch\",\"mainEntityOfPage\":{\"@id\":\"https://docs.rings.ai/api-reference/recommended-paths/person-batch#webpage\"},\"dateModified\":\"2026-07-17T10:17:51.917Z\",\"publisher\":{\"@id\":\"https://docs.rings.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.rings.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Rings AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Rings AI","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Person","pages":[{"title":"List persons","openapi":"GET /v1/persons","href":"/api-reference/person/list-persons"},{"title":"List person custom fields","openapi":"GET /v1/persons/custom-fields","href":"/api-reference/person/list-custom-fields"},{"title":"Create a person","openapi":"POST /v1/persons","href":"/api-reference/person/create-person"},{"title":"Batch create persons","openapi":"POST /v1/persons/batch","href":"/api-reference/person/batch-create"},{"title":"Lookup a person","openapi":"GET /v1/persons/lookup","href":"/api-reference/person/lookup"},{"title":"Batch lookup persons","openapi":"POST /v1/persons/lookup/batch","href":"/api-reference/person/lookup-batch"},{"title":"Get a person","openapi":"GET /v1/persons/{person_uuid}","href":"/api-reference/person/get-person"},{"title":"Update a person","openapi":"PUT /v1/persons/{person_uuid}","href":"/api-reference/person/update-person"},{"title":"Merge persons","openapi":"POST /v1/persons/{person_uuid}/merge","href":"/api-reference/person/merge-person"}]},{"group":"Company","pages":[{"title":"List companies","openapi":"GET /v1/companies","href":"/api-reference/company/list-companies"},{"title":"Create a company","openapi":"POST /v1/companies","href":"/api-reference/company/create-company"},{"title":"Lookup a company","openapi":"GET /v1/companies/lookup","href":"/api-reference/company/lookup"},{"title":"Get a company","openapi":"GET /v1/companies/{company_uuid}","href":"/api-reference/company/get-company"},{"title":"List company employees","openapi":"GET /v1/companies/{company_uuid}/employees","href":"/api-reference/company/list-employees"},{"title":"Update a company","openapi":"PUT /v1/companies/{company_uuid}","href":"/api-reference/company/update-company"},{"title":"Batch lookup companies","openapi":"POST /v1/companies/lookup/batch","href":"/api-reference/company/lookup-batch"}]},{"group":"Opportunity","pages":[{"title":"List opportunities","openapi":"GET /v1/opportunities","href":"/api-reference/opportunity/list-opportunities"},{"title":"Create an opportunity","openapi":"POST /v1/opportunities","href":"/api-reference/opportunity/create-opportunity"},{"title":"Get an opportunity","openapi":"GET /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/get-opportunity"},{"title":"Update an opportunity","openapi":"PUT /v1/opportunities/{opportunity_uuid}","href":"/api-reference/opportunity/update-opportunity"},{"title":"Delete opportunities","openapi":"DELETE /v1/opportunities","href":"/api-reference/opportunity/delete-opportunities"},{"title":"Add opportunity association","openapi":"POST /v1/opportunities/{opportunity_uuid}/associations","href":"/api-reference/opportunity/add-association"},{"title":"Delete opportunity association","openapi":"DELETE /v1/opportunities/{opportunity_uuid}/associations/{association_uuid}","href":"/api-reference/opportunity/delete-association"},{"title":"List opportunity types","openapi":"GET /v1/opportunity-types","href":"/api-reference/opportunity/list-types"},{"title":"List opportunity stages","openapi":"GET /v1/opportunity-types/{type_uuid}/stages","href":"/api-reference/opportunity/list-stages"},{"title":"List opportunities for a company","openapi":"GET /v1/companies/{company_uuid}/opportunities","href":"/api-reference/opportunity/list-by-company"},{"title":"List opportunities for a person","openapi":"GET /v1/persons/{person_uuid}/opportunities","href":"/api-reference/opportunity/list-by-person"}]},{"group":"Activity","pages":[{"title":"Get activity body","openapi":"GET /v1/activities/{activity_object_id}/body","href":"/api-reference/activity/get-body"},{"title":"Get activity thread","openapi":"GET /v1/activities/{activity_object_id}/thread","href":"/api-reference/activity/get-thread"},{"title":"Company activities","openapi":"GET /v1/companies/{company_uuid}/activities","href":"/api-reference/activity/company-activities"},{"title":"Company activity stats","openapi":"GET /v1/companies/{company_uuid}/activity-stats","href":"/api-reference/activity/company-activity-stats"},{"title":"Bulk company activity stats","openapi":"POST /v1/companies/activity-stats/batch","href":"/api-reference/activity/company-activity-stats-batch"},{"title":"Person activities","openapi":"GET /v1/persons/{person_uuid}/activities","href":"/api-reference/activity/person-activities"},{"title":"Person activity stats","openapi":"GET /v1/persons/{person_uuid}/activity-stats","href":"/api-reference/activity/person-activity-stats"},{"title":"Bulk person activity stats","openapi":"POST /v1/persons/activity-stats/batch","href":"/api-reference/activity/person-activity-stats-batch"}]},{"group":"Meetings","pages":[{"title":"List meetings","openapi":"GET /v1/meetings","href":"/api-reference/meetings/list-meetings"},{"title":"Get a meeting","openapi":"GET /v1/meetings/{activity_id}","href":"/api-reference/meetings/get-meeting"}]},{"group":"Note","pages":[{"title":"List notes","openapi":"GET /v1/notes","href":"/api-reference/note/list-notes"},{"title":"Create a note","openapi":"POST /v1/notes","href":"/api-reference/note/create-note"},{"title":"Batch create notes","openapi":"POST /v1/notes/batch","href":"/api-reference/note/batch-create"},{"title":"Search notes","openapi":"POST /v1/notes/search","href":"/api-reference/note/search"},{"title":"Get a note","openapi":"GET /v1/notes/{note_uuid}","href":"/api-reference/note/get-note"},{"title":"Update a note","openapi":"PUT /v1/notes/{note_uuid}","href":"/api-reference/note/update-note"},{"title":"Delete a note","openapi":"DELETE /v1/notes/{note_uuid}","href":"/api-reference/note/delete-note"},{"title":"Add note association","openapi":"POST /v1/notes/{note_uuid}/associations","href":"/api-reference/note/add-association"},{"title":"Delete note association","openapi":"DELETE /v1/notes/{note_uuid}/associations/{association_uuid}","href":"/api-reference/note/delete-association"}]},{"group":"Task","pages":[{"title":"List tasks","openapi":"GET /v1/tasks","href":"/api-reference/task/list-tasks"},{"title":"Create a task","openapi":"POST /v1/tasks","href":"/api-reference/task/create-task"},{"title":"Get a task","openapi":"GET /v1/tasks/{task_id}","href":"/api-reference/task/get-task"},{"title":"Update a task","openapi":"PUT /v1/tasks/{task_id}","href":"/api-reference/task/update-task"},{"title":"Delete a task","openapi":"DELETE /v1/tasks/{task_id}","href":"/api-reference/task/delete-task"},{"title":"Add task association","openapi":"POST /v1/tasks/{task_id}/associations","href":"/api-reference/task/add-association"},{"title":"Delete task association","openapi":"DELETE /v1/tasks/{task_id}/associations/{association_uuid}","href":"/api-reference/task/delete-association"}]},{"group":"Recommended Paths","pages":[{"title":"Recommended paths to a person","openapi":"GET /v1/persons/{person_uuid}/recommended-paths","href":"/api-reference/recommended-paths/person"},{"title":"Recommended paths to a company","openapi":"GET /v1/companies/{company_uuid}/recommended-paths","description":"\"who internally knows people at this company\" / \"best path into\" queries.\n\nReturns internal team members ranked by connection strength to people at\nthe target company, each with 2-hop relationship paths. Use this to find\nwho on the team can make introductions at a specific company.\n\nEach result includes the connector's name, relationship quality (rq),\nand the path hops linking them to contacts at the company.\n\nThe response also carries a top-level `top_external_contacts` array — the\ncompany's top 5 external contacts ranked by PathPower, each with their\nrole `tags` and two strongest internal connectors. This array is\nindependent of pagination.","href":"/api-reference/recommended-paths/company"},{"title":"Bulk recommended paths (persons)","openapi":"POST /v1/persons/recommended-paths/batch","href":"/api-reference/recommended-paths/person-batch"},{"title":"Bulk recommended paths (companies)","openapi":"POST /v1/companies/recommended-paths/batch","description":"\nBody: `uuids` (company UUIDs, max 100) plus optional `limit` (top contacts\nper target, default 25, max 100), `sort_by`, `order`, and `include_items`.\n`results` holds one entry per input UUID, in order; each carries that\ntarget's `total`, its top contacts, and the company's\n`top_external_contacts` (top 5 external contacts with role `tags` and\ntheir strongest internal connectors). Targets that are not found come back\nwith empty `items` rather than failing the whole batch.\n\nIf you only consume `top_external_contacts` and target-level fields, pass\n`include_items: false` to skip building `items` — dramatically faster for\nlarge batches (`items` comes back empty and `total` is 0).","href":"/api-reference/recommended-paths/company-batch"}]},{"group":"PathPower","pages":[{"title":"Bulk PathPower scores","openapi":"GET /v1/pathpower/scores","href":"/api-reference/pathpower/bulk-scores"},{"title":"PathPower for a person","openapi":"GET /v1/persons/{person_uuid}/pathpower","href":"/api-reference/pathpower/person"},{"title":"PathPower for a company","openapi":"GET /v1/companies/{company_uuid}/pathpower","href":"/api-reference/pathpower/company"}]},{"group":"Relationships","pages":[{"title":"List ring relationships","openapi":"GET /v1/relationships","href":"/api-reference/relationships/ring"},{"title":"My relationships","openapi":"GET /v1/relationships/mine","href":"/api-reference/relationships/mine"}]},{"group":"Intro","pages":[{"title":"List intros","openapi":"GET /v1/intros","href":"/api-reference/intro/list-intros"},{"title":"Log intro","openapi":"POST /v1/intros","href":"/api-reference/intro/log-intro"},{"title":"Update intro","openapi":"PUT /v1/intros/{intro_uuid}","href":"/api-reference/intro/update-intro"},{"title":"Delete intro","openapi":"DELETE /v1/intros/{intro_uuid}","href":"/api-reference/intro/delete-intro"},{"title":"List intro options","openapi":"GET /v1/intros/options","href":"/api-reference/intro/list-options"},{"title":"Get intro insights","openapi":"GET /v1/intros/insights","href":"/api-reference/intro/insights"}]},{"group":"AI Summary","pages":[{"title":"AI summary for a person","openapi":"GET /v1/persons/{person_uuid}/ai-summary","href":"/api-reference/ai-summary/person"},{"title":"AI summary for a company","openapi":"GET /v1/companies/{company_uuid}/ai-summary","href":"/api-reference/ai-summary/company"}]},{"group":"Entity Lists","pages":[{"title":"List entity lists","openapi":"GET /v1/lists","href":"/api-reference/lists/list-lists"},{"title":"List entity list members","openapi":"GET /v1/lists/{list_uuid}/entities","href":"/api-reference/lists/list-entities"},{"title":"Create an entity list","openapi":"POST /v1/lists","href":"/api-reference/lists/create-list"},{"title":"Update an entity list","openapi":"PUT /v1/lists/{list_uuid}","href":"/api-reference/lists/update-list"}]},{"group":"Users","pages":[{"title":"Get current user","openapi":"GET /v1/me","href":"/api-reference/users/me"},{"title":"List users","openapi":"GET /v1/users","href":"/api-reference/users/list-users"}]}]}]},"title":"Bulk recommended paths (persons) - Rings AI","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}