Natural language search query that finds cards with similar content. The query is converted to a vector representation and matches cards based on semantic similarity to card titles and details. Use filters for exact matches on card metadata (status, type, dates, etc.).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vistaly Knowledge Base","colors":{"primary":"#0284C7","light":"#6BB7F3","dark":"#2879CE"},"logo":{"light":"https://cdn.vistaly.com/assets/logo_light.svg","dark":"https://cdn.vistaly.com/assets/logo_dark.svg","href":"https://vistaly.com"},"favicon":"https://mintcdn.com/vistaly-b1df3861/vrmYpNPsEY8OQfgY/favicon.svg?fit=max\u0026auto=format\u0026n=vrmYpNPsEY8OQfgY\u0026q=85\u0026s=e21d183e8ace305263a428ed5191f671","navbar":{"links":[{"href":"mailto:support@vistaly.com","label":"Support"}],"primary":{"type":"button","label":"Sign In","href":"https://app.vistaly.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/vistaly","website":"https://vistaly.com"},"links":[{"items":[{"label":"Privacy Policy","href":"https://vistaly.com/privacy-policy"},{"label":"Terms of Service","href":"https://vistaly.com/terms-of-service"},{"label":"Cookie Policy","href":"https://vistaly.com/cookie-policy"},{"label":"GDPR Compliance","href":"https://vistaly.com/gdpr-compliance"}]}]},"banner":{"content":"📌 These are the docs for **Vistaly v1**. Looking for the **Vistaly v2** docs? Find them at [vistaly.com/docs](https://vistaly.com/docs).","dismissible":false,"type":"critical"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Book Onboarding Session","icon":"calendar-circle-user","href":"https://vistaly.com/request-a-trial"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vistaly-b1df3861","hasAudioNarration":false,"actualSubdomain":"vistaly-b1df3861","customDomains":["docs.vistaly.com"],"gitSource":{"type":"github","owner":"vistaly","repo":"app","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae9008fb53f45ac5e056e51","collectionId":"5a5e37bc-4410-4d48-9ec6-3bf2c423ecea","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae9008fb53f45ac5e056e51"},"entitlements":{},"buildId":"6ae9008fb53f45ac5e056e51","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Documentation","count":40},{"language":"default","tag":"API Documentation","count":26},{"language":"default","tag":"Endpoints","count":24},{"language":"default","tag":"Core Concepts","count":20},{"language":"default","tag":"Card Types","count":9},{"language":"default","tag":"Integrations","count":9},{"language":"default","tag":"cards","count":9},{"language":"default","tag":"Views \u0026 Workflows","count":6},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"interviews","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"img,video:not([id*=wistia]){border-radius:8px}video[id*=wistia]{margin-top:0!important}.image-caption{margin-top:-1rem;font-size:13px;line-height:18px;max-width:90%;margin-left:auto;margin-right:auto;opacity:.75;text-align:center}table td:first-child,table th:first-child{white-space:nowrap}.prose :where(h2):not(:where([class~=\"not-prose\"], [class~=\"not-prose\"] *)){font-size:1.75rem}.prose :where(h3):not(:where([class~=\"not-prose\"], [class~=\"not-prose\"] *)){font-size:1.5rem}.prose :where(h4):not(:where([class~=\"not-prose\"], [class~=\"not-prose\"] *)){font-size:1.25rem}.callout.rounded-2xl{border-radius:.75rem}"}],"page":{"pagePath":"api-reference/cards/search-cards-using-semantic-search","slug":"/api-reference/cards/search-cards-using-semantic-search","pageMetadata":{"title":"Search cards using semantic search","description":"Search for cards across your organization using natural language queries","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /beta/cards/search","href":"/api-reference/cards/search-cards-using-semantic-search","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search for cards across your organization using natural language queries\"\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":"Search cards using semantic search","description":"Search for cards across your organization using natural language queries","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /beta/cards/search","href":"/api-reference/cards/search-cards-using-semantic-search","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/vistaly-b1df3861/27942141871f3e8e/js/core.js"],"openApiReferenceData":{"operation":{"description":"Search for cards across your organization using natural language queries","requestBody":"8f4253e3-0267-404e-91e9-c32bc746c1d8","responses":{"200":"6f48f788-f1d8-4401-9d60-2c54a376ae95","400":"01416e0e-a760-418c-aa22-90871308ae3f","401":"e337560a-75ff-4c91-8609-e380d3f5fb82","403":"55f96905-559c-4161-ad36-60bd0cc5bbbd","500":"9bd10503-135c-4dea-b795-8bd7606f1a02"},"security":["c26ac9fd-dd26-41a6-a1e8-0952041d16d9"],"summary":"Search cards using semantic search","tags":["cards"],"method":"post","type":"path","servers":["e02224f0-d2db-4c42-8c14-4250436c551c"],"path":"/beta/cards/search","baseUrlOptions":["https://api.vistaly.com"],"title":"Search cards using semantic search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"filter":{"additionalProperties":false,"description":"Used to apply filters based on a card's metadata","properties":{"must":{"description":"Conditions that the matches must match","items":{"oneOf":[{"type":"object","description":"Used to filter cards based off their archived status","required":["key","match"],"properties":{"key":{"enum":["archived"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.0.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"boolean","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.0.match.value","typeLabel":"boolean"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.0.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their card type","required":["key","match"],"properties":{"key":{"enum":["card_type"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.1.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["assumption","experiment","kpi","objective","opportunity","outcome","problem","product","solution"],"type":"string","uniqueKey":"filter.must.items.[INDEX].oneOf.1.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.1.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.1.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Used to filter a card based off its current status","required":["key","match"],"properties":{"key":{"enum":["card_status"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.2.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["[experiment] developing","[experiment] pending","[experiment] running","[experiment] failed","[experiment] passed","[opportunity] identified","[opportunity] later","[opportunity] next","[opportunity] now","[opportunity] addressed","[opportunity] not now","[outcome] uncommitted","[outcome] at risk","[outcome] progressing","[outcome] on track","[kpi] observational","[kpi] out of limits","[kpi] within limits","[solution] idea","[solution] now","[solution] next","[solution] later","[solution] done","[solution] not now"],"type":"string","uniqueKey":"filter.must.items.[INDEX].oneOf.2.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.2.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.2.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Used to filter cards by created/updated timestamps","required":["key","range"],"properties":{"key":{"enum":["created_at","updated_at"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.3.key","typeLabel":"enum\u003cstring>"},"range":{"additionalProperties":false,"properties":{"gt":{"type":"string","format":"date-time","uniqueKey":"filter.must.items.[INDEX].oneOf.3.range.gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","uniqueKey":"filter.must.items.[INDEX].oneOf.3.range.gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","uniqueKey":"filter.must.items.[INDEX].oneOf.3.range.lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","uniqueKey":"filter.must.items.[INDEX].oneOf.3.range.lte","typeLabel":"string\u003cdate-time>"}},"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.3.range","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their workspace_id","required":["key","match"],"properties":{"key":{"enum":["workspace_id"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.4.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.4.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.4.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their labels","required":["key","match"],"properties":{"key":{"enum":["labels"],"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.5.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.5.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must.items.[INDEX].oneOf.5.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"filter.must.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"filter.must","typeLabel":"object[]"},"must_not":{"description":"Conditions that the matches must not match","items":{"oneOf":[{"type":"object","description":"Used to filter cards based off their archived status","required":["key","match"],"properties":{"key":{"enum":["archived"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.0.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"boolean","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.0.match.value","typeLabel":"boolean"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.0.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their card type","required":["key","match"],"properties":{"key":{"enum":["card_type"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.1.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["assumption","experiment","kpi","objective","opportunity","outcome","problem","product","solution"],"type":"string","uniqueKey":"filter.must_not.items.[INDEX].oneOf.1.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.1.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.1.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Used to filter a card based off its current status","required":["key","match"],"properties":{"key":{"enum":["card_status"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.2.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["[experiment] developing","[experiment] pending","[experiment] running","[experiment] failed","[experiment] passed","[opportunity] identified","[opportunity] later","[opportunity] next","[opportunity] now","[opportunity] addressed","[opportunity] not now","[outcome] uncommitted","[outcome] at risk","[outcome] progressing","[outcome] on track","[kpi] observational","[kpi] out of limits","[kpi] within limits","[solution] idea","[solution] now","[solution] next","[solution] later","[solution] done","[solution] not now"],"type":"string","uniqueKey":"filter.must_not.items.[INDEX].oneOf.2.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.2.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.2.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Used to filter cards by created/updated timestamps","required":["key","range"],"properties":{"key":{"enum":["created_at","updated_at"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.key","typeLabel":"enum\u003cstring>"},"range":{"additionalProperties":false,"properties":{"gt":{"type":"string","format":"date-time","uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.range.gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.range.gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.range.lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.range.lte","typeLabel":"string\u003cdate-time>"}},"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.3.range","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their workspace_id","required":["key","match"],"properties":{"key":{"enum":["workspace_id"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.4.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.4.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.4.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their labels","required":["key","match"],"properties":{"key":{"enum":["labels"],"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.5.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.5.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.5.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.must_not.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"filter.must_not.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"filter.must_not","typeLabel":"object[]"},"should":{"description":"Conditions that the matches should match","items":{"oneOf":[{"type":"object","description":"Used to filter cards based off their archived status","required":["key","match"],"properties":{"key":{"enum":["archived"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.0.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"boolean","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.0.match.value","typeLabel":"boolean"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.0.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their card type","required":["key","match"],"properties":{"key":{"enum":["card_type"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.1.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["assumption","experiment","kpi","objective","opportunity","outcome","problem","product","solution"],"type":"string","uniqueKey":"filter.should.items.[INDEX].oneOf.1.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.1.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.1.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"Used to filter a card based off its current status","required":["key","match"],"properties":{"key":{"enum":["card_status"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.2.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"required":["any"],"properties":{"any":{"items":{"enum":["[experiment] developing","[experiment] pending","[experiment] running","[experiment] failed","[experiment] passed","[opportunity] identified","[opportunity] later","[opportunity] next","[opportunity] now","[opportunity] addressed","[opportunity] not now","[outcome] uncommitted","[outcome] at risk","[outcome] progressing","[outcome] on track","[kpi] observational","[kpi] out of limits","[kpi] within limits","[solution] idea","[solution] now","[solution] next","[solution] later","[solution] done","[solution] not now"],"type":"string","uniqueKey":"filter.should.items.[INDEX].oneOf.2.match.any.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.2.match.any","typeLabel":"enum\u003cstring>[]"}},"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.2.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.2","typeLabel":"object"},{"type":"object","description":"Used to filter cards by created/updated timestamps","required":["key","range"],"properties":{"key":{"enum":["created_at","updated_at"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.3.key","typeLabel":"enum\u003cstring>"},"range":{"additionalProperties":false,"properties":{"gt":{"type":"string","format":"date-time","uniqueKey":"filter.should.items.[INDEX].oneOf.3.range.gt","typeLabel":"string\u003cdate-time>"},"gte":{"type":"string","format":"date-time","uniqueKey":"filter.should.items.[INDEX].oneOf.3.range.gte","typeLabel":"string\u003cdate-time>"},"lt":{"type":"string","format":"date-time","uniqueKey":"filter.should.items.[INDEX].oneOf.3.range.lt","typeLabel":"string\u003cdate-time>"},"lte":{"type":"string","format":"date-time","uniqueKey":"filter.should.items.[INDEX].oneOf.3.range.lte","typeLabel":"string\u003cdate-time>"}},"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.3.range","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.3","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their workspace_id","required":["key","match"],"properties":{"key":{"enum":["workspace_id"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.4.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.4.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.4.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.4","typeLabel":"object"},{"type":"object","description":"Used to filter cards based off their labels","required":["key","match"],"properties":{"key":{"enum":["labels"],"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.5.key","typeLabel":"enum\u003cstring>"},"match":{"additionalProperties":false,"properties":{"value":{"type":"string","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.5.match.value","typeLabel":"string"}},"required":["value"],"type":"object","isRequired":true,"uniqueKey":"filter.should.items.[INDEX].oneOf.5.match","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"filter.should.items.[INDEX].oneOf.5","typeLabel":"object"}],"uniqueKey":"filter.should.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"filter.should","typeLabel":"object[]"}},"type":"object","uniqueKey":"filter","typeLabel":"object"},"query":{"description":"Natural language search query that finds cards with similar content. The query is converted to a vector representation and matches cards based on semantic similarity to card titles and details. Use filters for exact matches on card metadata (status, type, dates, etc.).","type":"string","uniqueKey":"query","typeLabel":"string"}},"required":[],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"filter":{"must":[{"key":"archived","match":{"value":true}}],"must_not":[{"key":"archived","match":{"value":true}}],"should":[{"key":"archived","match":{"value":true}}]},"query":"\u003cstring>"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"6f48f788-f1d8-4401-9d60-2c54a376ae95":{"content":{"application/json":{"example":{"message":"Cards searched"},"schema":{"additionalProperties":false,"properties":{"message":{"example":"System provided message","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Cards searched"}}},"exampleType":"examples"}},"description":"Metrics submitted successfully","exampleType":"examples"},"01416e0e-a760-418c-aa22-90871308ae3f":{"description":"Bad request","content":{"application/json":{"example":{"message":"Bad request"},"schema":{"additionalProperties":false,"properties":{"message":{"example":"System provided message","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Bad request"}}},"exampleType":"examples"}},"exampleType":"examples"},"e337560a-75ff-4c91-8609-e380d3f5fb82":{"description":"Unauthorized","content":{"application/json":{"example":{"message":"Unauthorized"},"schema":{"additionalProperties":false,"properties":{"message":{"example":"System provided message","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"55f96905-559c-4161-ad36-60bd0cc5bbbd":{"description":"Forbidden","content":{"application/json":{"example":{"message":"Forbidden"},"schema":{"additionalProperties":false,"properties":{"message":{"example":"System provided message","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"9bd10503-135c-4dea-b795-8bd7606f1a02":{"description":"Internal Server Error","content":{"application/json":{"example":{"message":"Internal server error"},"schema":{"additionalProperties":false,"properties":{"message":{"example":"System provided message","type":"string","uniqueKey":"message","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Internal server error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c26ac9fd-dd26-41a6-a1e8-0952041d16d9":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"e02224f0-d2db-4c42-8c14-4250436c551c":{"description":"Production server","url":"https://api.vistaly.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.vistaly.com/v1/swagger.json"},"subdomain":"vistaly-b1df3861","siteName":"Vistaly Knowledge Base","title":"Search cards using semantic search - Vistaly Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T21:28:53.223Z","originalFileLocation":"api-reference/cards/search-cards-using-semantic-search.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=\"system\"}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=\"Search for cards across your organization using natural language queries\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vistaly Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/svg+xml\" sizes=\"180x180\" href=\"https://mintcdn.com/vistaly-b1df3861/vrmYpNPsEY8OQfgY/favicon.svg?fit=max\u0026amp;auto=format\u0026amp;n=vrmYpNPsEY8OQfgY\u0026amp;q=85\u0026amp;s=e21d183e8ace305263a428ed5191f671\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"32x32\" href=\"https://mintcdn.com/vistaly-b1df3861/vrmYpNPsEY8OQfgY/favicon.svg?fit=max\u0026amp;auto=format\u0026amp;n=vrmYpNPsEY8OQfgY\u0026amp;q=85\u0026amp;s=e21d183e8ace305263a428ed5191f671\">\u003clink data-mint-head rel=\"icon\" type=\"image/svg+xml\" sizes=\"16x16\" href=\"https://mintcdn.com/vistaly-b1df3861/vrmYpNPsEY8OQfgY/favicon.svg?fit=max\u0026amp;auto=format\u0026amp;n=vrmYpNPsEY8OQfgY\u0026amp;q=85\u0026amp;s=e21d183e8ace305263a428ed5191f671\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/svg+xml\" href=\"https://mintcdn.com/vistaly-b1df3861/vrmYpNPsEY8OQfgY/favicon.svg?fit=max\u0026amp;auto=format\u0026amp;n=vrmYpNPsEY8OQfgY\u0026amp;q=85\u0026amp;s=e21d183e8ace305263a428ed5191f671\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search cards using semantic search - Vistaly Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search for cards across your organization using natural language queries\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vistaly Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vistaly-b1df3861.mintlify.app/_mintlify/api/og/v2?division=cards\u0026amp;title=Search+cards+using+semantic+search\u0026amp;description=Search+for+cards+across+your+organization+using+natural+language+queries\u0026amp;theme=dee2c3a91da685acab0eb1e2\u0026amp;signature=9f1e8798fc5ae881671fd0caec019e69f6beec6f73fde20a85b50529b0665054\">\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=\"Search cards using semantic search - Vistaly Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search for cards across your organization using natural language queries\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vistaly-b1df3861.mintlify.app/_mintlify/api/og/v2?division=cards\u0026amp;title=Search+cards+using+semantic+search\u0026amp;description=Search+for+cards+across+your+organization+using+natural+language+queries\u0026amp;theme=dee2c3a91da685acab0eb1e2\u0026amp;signature=9f1e8798fc5ae881671fd0caec019e69f6beec6f73fde20a85b50529b0665054\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/vistaly-b1df3861/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vistaly Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0284C7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cards/search-cards-using-semantic-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vistaly.com/#organization\",\"name\":\"Vistaly Knowledge Base\",\"url\":\"https://docs.vistaly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://cdn.vistaly.com/assets/logo_light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vistaly.com#website\",\"name\":\"Vistaly Knowledge Base\",\"url\":\"https://docs.vistaly.com\",\"publisher\":{\"@id\":\"https://docs.vistaly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search#webpage\",\"url\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search\",\"name\":\"Search cards using semantic search\",\"description\":\"Search for cards across your organization using natural language queries\",\"dateModified\":\"2026-11-02T21:28:53.223Z\",\"isPartOf\":{\"@id\":\"https://docs.vistaly.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.vistaly.com/api-reference/cards/get-card-details\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"cards\",\"item\":\"https://docs.vistaly.com/api-reference/cards/get-card-details\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Search cards using semantic search\",\"item\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search#apireference\",\"headline\":\"Search cards using semantic search\",\"name\":\"Search cards using semantic search\",\"description\":\"Search for cards across your organization using natural language queries\",\"url\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vistaly.com/api-reference/cards/search-cards-using-semantic-search#webpage\"},\"dateModified\":\"2026-11-02T21:28:53.223Z\",\"publisher\":{\"@id\":\"https://docs.vistaly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vistaly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vistaly Knowledge Base\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vistaly Knowledge Base","nav":{"global":{"anchors":[{"anchor":"Book Onboarding Session","icon":"calendar-circle-user","href":"https://vistaly.com/request-a-trial"}]},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/getting-started/introduction"}]},{"tab":"Documentation","pages":[{"title":"Documentation","href":"/documentation/views/tree"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/latest"}]},{"tab":"API Documentation","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"cards","pages":[{"title":"Get card details","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /beta/cards/{cardId}","href":"/api-reference/cards/get-card-details"},{"title":"Update card","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json put /beta/cards/{cardId}","href":"/api-reference/cards/update-card"},{"title":"Create a new card","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /beta/cards","href":"/api-reference/cards/create-a-new-card"},{"title":"List comments for a card","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /beta/cards/{cardId}/comments","href":"/api-reference/cards/list-comments-for-a-card"},{"title":"Get card context","description":"Retrieve hierarchical context for a card including ancestors (parent cards), descendants (child cards), or both. Each card in the response includes a 'level' field (0=target card, positive integers=distance from target) and a 'children' array (IDs of direct child cards). Use direction='ancestors' to understand what problems/objectives a card supports, direction='descendants' to see solutions/experiments beneath a card, or direction='both' for complete tree context. The hierarchy can be reconstructed using the children arrays and level fields.","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /beta/cards/{cardId}/context","href":"/api-reference/cards/get-card-context"},{"title":"Search cards using semantic search","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /beta/cards/search","href":"/api-reference/cards/search-cards-using-semantic-search"},{"title":"Submit metrics for a card","description":"Submit various metrics related to a specific card identified by `cardId`. This allows for tracking and performance measurement of the card.","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /v1/cards/{cardId}/metrics","href":"/api-reference/cards/submit-metrics-for-a-card"},{"title":"Submit bulk metrics for a card","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /v1/cards/{cardId}/metrics/bulk","href":"/api-reference/cards/submit-bulk-metrics-for-a-card"},{"title":"Update card parents","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json put /beta/cards/{cardId}/parents","href":"/api-reference/cards/update-card-parents"}]},{"group":"system","pages":[{"title":"Auth info endpoint","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/auth/info","href":"/api-reference/system/auth-info-endpoint"},{"title":"Health check endpoint","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/health","href":"/api-reference/system/health-check-endpoint"}]},{"group":"feedback","pages":[{"title":"List feedback","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/feedback","href":"/api-reference/feedback/list-feedback"},{"title":"Submit user feedback","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /v1/feedback","href":"/api-reference/feedback/submit-user-feedback"},{"title":"Get feedback","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/feedback/{feedbackId}","href":"/api-reference/feedback/get-feedback"},{"title":"Delete feedback","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json delete /v1/feedback/{feedbackId}","href":"/api-reference/feedback/delete-feedback"},{"title":"Process feedback","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /v1/feedback/{feedbackId}/process","href":"/api-reference/feedback/process-feedback"}]},{"group":"documentation","pages":[{"title":"Redirect to full LLM documentation","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/docs/full","href":"/api-reference/documentation/redirect-to-full-llm-documentation"},{"title":"Redirect to summary LLM documentation","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/docs/summary","href":"/api-reference/documentation/redirect-to-summary-llm-documentation"}]},{"group":"interviews","pages":[{"title":"List interviews","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/interviews","href":"/api-reference/interviews/list-interviews"},{"title":"Submit interview data","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json post /v1/interviews","href":"/api-reference/interviews/submit-interview-data"},{"title":"Delete interview","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json delete /v1/interviews/{interviewId}","href":"/api-reference/interviews/delete-interview"},{"title":"Get interview transcript","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/interviews/{interviewId}/transcript","href":"/api-reference/interviews/get-interview-transcript"},{"title":"Get interview notes","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/interviews/{interviewId}/notes","href":"/api-reference/interviews/get-interview-notes"},{"title":"Get interview insights","deprecated":null,"version":null,"openapi":"https://api.vistaly.com/v1/swagger.json get /v1/interviews/{interviewId}/insights","href":"/api-reference/interviews/get-interview-insights"}]}]}]},{"tab":"MCP Cookbook","pages":[{"title":"MCP Cookbook","href":"/mcp-cookbook"}]}]},"basePath":"","title":"Search cards using semantic search - Vistaly Knowledge Base","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-DIeMibn4.js","dist-DJnKvr0g.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","clsx-B2v50t8t.js","html-void-elements-mCSPHezU.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","AssistantPageLink-BHrrjR1K.js"]}