Ranks the project’s connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.
Body
application/json
query
string
required
Search query for finding connector actions
Example:
"send a message"
connector
string
Filter by connector key, at any version. Shorthand for connector_versions: { "<key>": ["*"] }, which takes priority when both are sent.
Example:
"slack"
connector_versions
object
Connector versions to search, keyed by connector key. Takes priority over connector. At most 100 connector keys and 500 versions in total. latest is not accepted — pass resolved versions such as 1.2.0, or * for any version of that connector. * cannot be mixed with explicit versions in the same list. Explicit versions are returned as-is; * is deduplicated to the highest semver per action, and one map may mix the two forms across connectors.
Show child attributes
Example:
{ "slack": ["1.2.0", "1.3.1"], "hubspot": ["*"] }
top_k
number
default:100
Number of results to return
Required range: 1 <= x <= 500
min_similarity
number
default:0.2
Minimum similarity score threshold (0-1). Results below this score are filtered out.
Required range: 0 <= x <= 1
Example:
0.2
Response
Search results
results
object[]
required
Show child attributes
total_count
number
required
Total number of results returned
query
string
required
Original search query
connector_filter
string
Connector filter applied
project_filter
string
Project filter applied
returned_by_connector
object
Per connector key, the number of rows returned in this result window, seeded to 0 for every connector key the caller asked for. This is a window count, not a match count: read 0 as "not indexed yet" only when truncated is false, since a full window can crowd out a connector that is fully indexed.
Show child attributes
Example:
{ "slack": 7, "hubspot": 0 }
truncated
boolean
Whether the vector store filled the entire top_k budget, so results were cut off.
Example:
false
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Stackone","colors":{"primary":"#068F56","light":"#00AF66","dark":"#068F56"},"logo":{"light":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f","dark":"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-dark-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=b57d63594c13dee65c06a2d578927466","href":"/introduction"},"favicon":"https://mintcdn.com/stackone-60/EZ7nWzE-JJzhmP-C/images/logo/favicon.png?fit=max\u0026auto=format\u0026n=EZ7nWzE-JJzhmP-C\u0026q=85\u0026s=9012a8ae6ce9a80698406b611be47925","appearance":{"default":"light"},"background":{"image":{"light":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/light.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=112166d244e990ebc0146ff96958757c","dark":"https://mintcdn.com/stackone-60/knwbcGlYFJSeLObv/images/background/dark.svg?fit=max\u0026auto=format\u0026n=knwbcGlYFJSeLObv\u0026q=85\u0026s=50ec5e23eeb91f55e78a0da97dcaeb7b"},"color":{"dark":"#1a1a1a"}},"navbar":{"links":[{"icon":"circle-question","href":"/support","label":"Support"},{"href":"https://app.stackone.com","label":"Login"},{"href":"https://www.stackone.com/demo/","label":"Book a demo"}],"primary":{"type":"button","label":"Start Free","href":"https://app.stackone.com/sign_up"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/stackonehq","twitter":"https://twitter.com/StackOneHQ"}},"seo":{"metatags":{"canonical":"https://docs.stackone.com","google-site-verification":"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys"}},"fonts":{"heading":{"family":"Sf Pro Display","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"},"body":{"family":"Inter","source":"https://fonts.gstatic.com/s/inter/v18/UcC73FwrK3iLTeHuS_nVMrMxCp50SjIa1ZL7W0Q5nw.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"gtm":{"tagId":"GTM-NZNK37TL"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"stackone-60","hasAudioNarration":false,"actualSubdomain":"stackone-60","customDomains":["docs.stackone.com"],"gitSource":{"type":"github","owner":"stackonehq","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"issues":false,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af7fbdaf773a48258620aa6","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"default","tag":"Connectors","count":6773},{"language":"default","tag":"Connector Catalog","count":3365},{"language":"default","tag":"Embed","count":84},{"language":"default","tag":"Platform API","count":65},{"language":"default","tag":"Features","count":48},{"language":"default","tag":"Connector Building","count":42},{"language":"default","tag":"AI Platforms","count":39},{"language":"default","tag":"Unified Actions","count":39},{"language":"default","tag":"Gateway","count":38},{"language":"default","tag":"Embed StackOne","count":36}],"searchSettings":{"isFiltersEnabled":true}},"assistantConfig":{"enableStarterQuestions":false,"deflection":{"enabled":true,"email":"support@stackone.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"rbac-expansion","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":"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":"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":"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":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/stackone-60/1689b391b56fc5fb/style.css"}],"page":{"pagePath":"platform/api-reference/actions/search-connector-actions-by-semantic-similarity","slug":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity","pageMetadata":{"openapi":"post /actions/search","title":"Search connector actions by semantic similarity","description":"Ranks the project's connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.","href":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity"},"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: \"Ranks the project’s connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\"\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":{"openapi":"post /actions/search","title":"Search connector actions by semantic similarity","description":"Ranks the project's connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.","href":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/stackone-60/072d59ca3ea476f6/status-indicator.js","/_mintlify/custom/stackone-60/108e4b0e256a9ba7/connectors.js","/_mintlify/custom/stackone-60/af28b3fbb0435529/hubspot-form.js","/_mintlify/custom/stackone-60/965ecce887247b53/end-users.js"],"openApiReferenceData":{"operation":{"description":"Ranks the project's connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.","operationId":"stackone_search_actions","parameters":[],"requestBody":"42dd64ce-d1f1-4f9a-9d59-b432d2638348","responses":{"200":"ee3a5e7a-b9a0-4be0-9992-c8980b67e076","400":"64e396fe-817b-4f00-9042-0a7ab5d28faa","401":"a3591668-58e2-4a35-93f8-db3d9a2be121","403":"375b1e38-3351-4327-86d3-8b53fbfb3f50","404":"b9ff96c5-7645-4d4b-b9d1-7e626260e402","408":"71437958-0d1a-4040-aee9-6be55aa75e22","409":"058443b5-0018-4d81-af5c-92c2d91c10bb","422":"c24c6ccd-1b2e-4f21-a63e-9b29fd887039","429":"7556ed0f-8312-41d6-b35d-a41a38544499","500":"b4c2dbf3-1ba6-4795-99f0-c2b9c5686b4e","501":"715c1361-99a5-4df5-8b29-6e5d1ba172d0","502":"19dba3e2-b6d4-4b75-905a-189093b4507e"},"security":["da52f7fa-26c3-4bf5-a198-1dd47fe53456"],"summary":"Search connector actions by semantic similarity","tags":["Actions"],"x-speakeasy-name-override":"search_actions","x-speakeasy-retries":{"statusCodes":[429,408],"strategy":"backoff"},"method":"post","type":"path","servers":["b8eaeb12-7fcd-41ae-acd4-6c1188543c50"],"path":"/actions/search","baseUrlOptions":["https://api.stackone.com"],"title":"Search connector actions by semantic similarity","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for finding connector actions","example":"send a message","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"connector":{"type":"string","description":"Filter by connector key, at any version. Shorthand for `connector_versions: { \"\u003ckey>\": [\"*\"] }`, which takes priority when both are sent.","example":"slack","uniqueKey":"connector","typeLabel":"string"},"connector_versions":{"type":"object","description":"Connector versions to search, keyed by connector key. Takes priority over `connector`. At most 100 connector keys and 500 versions in total. `latest` is not accepted — pass resolved versions such as `1.2.0`, or `*` for any version of that connector. `*` cannot be mixed with explicit versions in the same list. Explicit versions are returned as-is; `*` is deduplicated to the highest semver per action, and one map may mix the two forms across connectors.","example":{"slack":["1.2.0","1.3.1"],"hubspot":["*"]},"additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"connector_versions.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"connector_versions.additionalProperties","typeLabel":"string[]"},"uniqueKey":"connector_versions","typeLabel":"object"},"top_k":{"type":"number","description":"Number of results to return","default":100,"minimum":1,"maximum":500,"uniqueKey":"top_k","typeLabel":"number"},"min_similarity":{"type":"number","description":"Minimum similarity score threshold (0-1). Results below this score are filtered out.","example":0.2,"default":0.2,"minimum":0,"maximum":1,"uniqueKey":"min_similarity","typeLabel":"number"}},"required":["query"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"send a message","connector":"slack","connector_versions":{"slack":["1.2.0","1.3.1"],"hubspot":["*"]},"top_k":100,"min_similarity":0.2}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ee3a5e7a-b9a0-4be0-9992-c8980b67e076":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Opaque action identifier. Do not parse it: a connector key and an action id may both contain \"_\" and a scope may contain \"/\", so it does not split into fixed parts. Resolve it against the connector registry instead.","example":"slack_1.0.0_slack_send_message_global","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string"},"similarity_score":{"type":"number","description":"Cosine similarity score (0-1)","isRequired":true,"uniqueKey":"results.items.[INDEX].similarity_score","typeLabel":"number"},"prerequisite_actions":{"description":"Prerequisite action IDs that should be run first to obtain IDs this action needs","type":"array","items":{"type":"string","uniqueKey":"results.items.[INDEX].prerequisite_actions.items.[INDEX]","typeLabel":"string"},"uniqueKey":"results.items.[INDEX].prerequisite_actions","typeLabel":"string[]"}},"required":["id","similarity_score"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"total_count":{"type":"number","description":"Total number of results returned","isRequired":true,"uniqueKey":"total_count","typeLabel":"number"},"query":{"type":"string","description":"Original search query","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"connector_filter":{"type":"string","description":"Connector filter applied","uniqueKey":"connector_filter","typeLabel":"string"},"project_filter":{"type":"string","description":"Project filter applied","uniqueKey":"project_filter","typeLabel":"string"},"returned_by_connector":{"type":"object","description":"Per connector key, the number of rows returned in this result window, seeded to 0 for every connector key the caller asked for. This is a window count, not a match count: read 0 as \"not indexed yet\" only when `truncated` is false, since a full window can crowd out a connector that is fully indexed.","example":{"slack":7,"hubspot":0},"additionalProperties":{"type":"number","uniqueKey":"returned_by_connector.additionalProperties","typeLabel":"number"},"uniqueKey":"returned_by_connector","typeLabel":"object"},"truncated":{"type":"boolean","description":"Whether the vector store filled the entire top_k budget, so results were cut off.","example":false,"uniqueKey":"truncated","typeLabel":"boolean"}},"required":["results","total_count","query"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"id":"slack_1.0.0_slack_send_message_global","similarity_score":123,"prerequisite_actions":["\u003cstring>"]}],"total_count":123,"query":"\u003cstring>","connector_filter":"\u003cstring>","project_filter":"\u003cstring>","returned_by_connector":{"slack":7,"hubspot":0},"truncated":false}}},"exampleType":"generated"}},"exampleType":"generated"},"64e396fe-817b-4f00-9042-0a7ab5d28faa":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Request","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"},"data":{"oneOf":[{"type":"object","description":"Error details","properties":{"statusCode":{"oneOf":[{"type":"number","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code","example":400,"uniqueKey":"data.oneOf.0.statusCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.statusCode","typeLabel":"number | null"},"message":{"oneOf":[{"type":"string","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Error message","example":"Bad Request","uniqueKey":"data.oneOf.0.message.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.message","typeLabel":"string | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"data.oneOf.0.headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.headers","typeLabel":"object | null"}},"uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | null"},"provider_errors":{"oneOf":[{"description":"List of provider-specific errors","type":"array","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.0","typeLabel":"number"},{"type":"null","description":"HTTP status code of the provider error","example":400,"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].status","typeLabel":"number | null"},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource","uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.0","typeLabel":"object"},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].raw","typeLabel":"object | null"},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.0","typeLabel":"object"},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors.oneOf.0.items.[INDEX].headers","typeLabel":"object | null"}},"uniqueKey":"provider_errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"provider_errors.oneOf.0","typeLabel":"object[]"},{"description":"List of provider-specific errors","type":"null","items":{"type":"object","properties":{"status":{"oneOf":[{"type":"number","description":"HTTP status code of the provider error","example":400},{"type":"null","description":"HTTP status code of the provider error","example":400}]},"url":{"oneOf":[{"type":"string","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"},{"type":"null","description":"URL that caused the error","example":"https://api.provider.com/v1/resource"}]},"raw":{"oneOf":[{"type":"object","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}},{"type":"null","description":"Raw error response from the provider","example":{"message":"Invalid input parameters"}}]},"headers":{"oneOf":[{"type":"object","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},{"type":"null","description":"Response headers","example":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"uniqueKey":"provider_errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_errors","typeLabel":"object[] | null"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"message":"Bad Request","timestamp":"2023-05-30T00:00:00.000Z","data":{"statusCode":400,"message":"Bad Request","headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}},"provider_errors":[{"status":400,"url":"https://api.provider.com/v1/resource","raw":{"message":"Invalid input parameters"},"headers":{"content-type":"application/json","x-request-id":"5678c28b211dace4e0a0f9171e6b88c5"}}]}}},"exampleType":"generated"}},"exampleType":"generated"},"a3591668-58e2-4a35-93f8-db3d9a2be121":{"description":"Unauthorized access.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":401,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unauthorized","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"message":"Unauthorized","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"375b1e38-3351-4327-86d3-8b53fbfb3f50":{"description":"Forbidden.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":403,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Forbidden resource","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"message":"Forbidden resource","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"b9ff96c5-7645-4d4b-b9d1-7e626260e402":{"description":"Resource not found.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":404,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Found","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"message":"Not Found","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"71437958-0d1a-4040-aee9-6be55aa75e22":{"description":"The request has timed out.","headers":{"Retry-After":{"description":"A time in seconds after which the request can be retried.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":408,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Request timed out","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":408,"message":"Request timed out","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"058443b5-0018-4d81-af5c-92c2d91c10bb":{"description":"Conflict with current state.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":409,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Conflict","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":409,"message":"Conflict","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"c24c6ccd-1b2e-4f21-a63e-9b29fd887039":{"description":"Validation error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":422,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Unprocessable Entity","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":422,"message":"Unprocessable Entity","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"7556ed0f-8312-41d6-b35d-a41a38544499":{"description":"Too many requests.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":429,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Too many requests","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":429,"message":"Too many requests","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"b4c2dbf3-1ba6-4795-99f0-c2b9c5686b4e":{"description":"Server error while executing the request.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":500,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Internal server error","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":500,"message":"Internal server error","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"715c1361-99a5-4df5-8b29-6e5d1ba172d0":{"description":"This functionality is not implemented.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":501,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Not Implemented","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":501,"message":"Not Implemented","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"},"19dba3e2-b6d4-4b75-905a-189093b4507e":{"description":"Bad gateway error.","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code","example":502,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"number"},"message":{"type":"string","description":"Error message","example":"Bad Gateway","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","description":"Timestamp when the error occurred","example":"2023-05-30T00:00:00.000Z","format":"date-time","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"required":["statusCode","message","timestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"statusCode":502,"message":"Bad Gateway","timestamp":"2023-05-30T00:00:00.000Z"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"da52f7fa-26c3-4bf5-a198-1dd47fe53456":{"basic":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"}}},"servers":{"b8eaeb12-7fcd-41ae-acd4-6c1188543c50":{"url":"https://api.stackone.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basic"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basic","name":"Authorization"}],"title":"basic"}]},"originalFileLocation":"platform/api-reference/platform.json"},"subdomain":"stackone-60","siteName":"Stackone","title":"Search connector actions by semantic similarity - Stackone","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T12:59:04.197Z","originalFileLocation":"platform/api-reference/actions/search-connector-actions-by-semantic-similarity.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=\"light\"}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=\"Ranks the project\u0026#x27;s connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Stackone\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search connector actions by semantic similarity - Stackone\">\u003cmeta data-mint-head property=\"og:description\" content=\"Ranks the project\u0026#x27;s connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Stackone\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Actions\u0026amp;title=Search+connector+actions+by+semantic+similarity\u0026amp;description=Ranks+the+project%27s+connector+actions+by+how+closely+they+match+a+natural-language+query%2C+so+an+agent+can+find+the+right+action+without+reading+the+whole+catalo\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=0357bb54995e160e2c2c876799dd9a288092112484caa60c6f7b0206c3810da4\">\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 connector actions by semantic similarity - Stackone\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Ranks the project\u0026#x27;s connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://stackone-60.mintlify.site/_mintlify/api/og/v2?division=Actions\u0026amp;title=Search+connector+actions+by+semantic+similarity\u0026amp;description=Ranks+the+project%27s+connector+actions+by+how+closely+they+match+a+natural-language+query%2C+so+an+agent+can+find+the+right+action+without+reading+the+whole+catalo\u0026amp;theme=26a0c4b0d3b33d43a09092cd\u0026amp;signature=0357bb54995e160e2c2c876799dd9a288092112484caa60c6f7b0206c3810da4\">\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/stackone-60/vUkZo0TYnLvO23Z1/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Stackone\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#068F56\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"gYj1x4gkdSwpCGVLFVXNVOPQ_wVrePW37ZKJt3HEqys\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.stackone.com/#organization\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/stackone-60/WsmKpuoeBZmio9QO/images/logo/logo-light-mode.svg?fit=max\u0026auto=format\u0026n=WsmKpuoeBZmio9QO\u0026q=85\u0026s=f08be9c0a142cb1e7fcaa23910c4bf7f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.stackone.com#website\",\"name\":\"Stackone\",\"url\":\"https://docs.stackone.com\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity#webpage\",\"url\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity\",\"name\":\"Search connector actions by semantic similarity\",\"description\":\"Ranks the project's connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\",\"dateModified\":\"2026-08-27T12:59:04.197Z\",\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Stackone\",\"item\":\"https://docs.stackone.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search connector actions by semantic similarity\",\"item\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity#apireference\",\"headline\":\"Search connector actions by semantic similarity\",\"name\":\"Search connector actions by semantic similarity\",\"description\":\"Ranks the project's connector actions by how closely they match a natural-language query, so an agent can find the right action without reading the whole catalog.\",\"url\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity\",\"mainEntityOfPage\":{\"@id\":\"https://docs.stackone.com/platform/api-reference/actions/search-connector-actions-by-semantic-similarity#webpage\"},\"dateModified\":\"2026-08-27T12:59:04.197Z\",\"publisher\":{\"@id\":\"https://docs.stackone.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.stackone.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Stackone\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Stackone\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity.md","siteName":"Stackone","nav":{"global":null,"tabs":[{"tab":"Gateway","icon":"rocket","pages":[{"title":"Gateway","href":"/introduction"}]},{"tab":"AI Platforms","icon":"robot","dropdowns":[{"dropdown":"All platforms","icon":"server","description":"Connect any MCP client","groups":[{"group":"Get Started","pages":[{"title":"AI Platforms","sidebarTitle":"Overview","href":"/ai-platforms/overview"},{"title":"StackOne MCP Server","sidebarTitle":"How the MCP Server Works","href":"/ai-platforms/mcp-server"}]}]},{"dropdown":"Anthropic (Claude)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/claude.svg","description":"Claude Chat, Cowork and Claude Code","groups":[{"group":"Anthropic (Claude)","pages":[{"title":"Anthropic (Claude)","sidebarTitle":"Overview","href":"/ai-platforms/anthropic/overview"},{"title":"Claude - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/anthropic/organization-admin-setup"},{"group":"Claude Chat \u0026 Cowork","expanded":true,"pages":[{"title":"Claude Chat \u0026 Cowork - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/anthropic/claude-chat-cowork/organization-user-setup"},{"title":"Claude Chat \u0026 Cowork - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/anthropic/claude-chat-cowork/personal-setup"}]},{"group":"Claude Code","expanded":true,"pages":[{"title":"Claude Code - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/anthropic/claude-code/organization-user-setup"},{"title":"Claude Code - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/anthropic/claude-code/personal-setup"}]}]}]},{"dropdown":"AWS","icon":"aws","description":"Amazon Quick","groups":[{"group":"AWS","pages":[{"title":"AWS","sidebarTitle":"Overview","href":"/ai-platforms/aws/overview"}]},{"group":"Amazon Quick","pages":[{"title":"Amazon Quick - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/aws/amazon-quick/organization-admin-setup"},{"title":"Amazon Quick - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/aws/amazon-quick/organization-user-setup"},{"title":"Amazon Quick - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/aws/amazon-quick/personal-setup"}]}]},{"dropdown":"Cursor","icon":"arrow-pointer","description":"Cursor editor","groups":[{"group":"Cursor","pages":[{"title":"Cursor","sidebarTitle":"Overview","href":"/ai-platforms/cursor/overview"},{"title":"Cursor - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/cursor/organization-user-setup"},{"title":"Cursor - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/cursor/personal-setup"}]}]},{"dropdown":"Dust","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/dust.png","description":"Dust assistants and agents","groups":[{"group":"Dust","pages":[{"title":"Dust","sidebarTitle":"Overview","href":"/ai-platforms/dust/overview"},{"title":"Dust - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/dust/connect-stackone"}]}]},{"dropdown":"Glean","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/glean.png","description":"Glean Agents and Glean Assistant","groups":[{"group":"Glean","pages":[{"title":"Glean","sidebarTitle":"Overview","href":"/ai-platforms/glean/overview"},{"title":"Glean - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/glean/organization-admin-setup"},{"group":"Glean Agents","expanded":true,"pages":[{"title":"Glean Agents - Connect StackOne","sidebarTitle":"Agent Builder Setup","href":"/ai-platforms/glean/glean-agents/agent-builder-setup"}]},{"group":"Glean Assistant","expanded":true,"pages":[{"title":"Glean Assistant - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/glean/glean-assistant/organization-user-setup"}]}]}]},{"dropdown":"Google","icon":"google","description":"Gemini CLI and Gemini Enterprise","groups":[{"group":"Google","pages":[{"title":"Google","sidebarTitle":"Overview","href":"/ai-platforms/google/overview"}]},{"group":"Gemini CLI","pages":[{"title":"Gemini CLI - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/google/gemini-cli/connect-stackone"}]},{"group":"Gemini Enterprise","pages":[{"title":"Gemini Enterprise - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/google/gemini-enterprise/connect-stackone"}]}]},{"dropdown":"Goose","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/goose.png","description":"Goose CLI and Desktop","groups":[{"group":"Goose","pages":[{"title":"Goose","sidebarTitle":"Overview","href":"/ai-platforms/goose/overview"},{"title":"Goose - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/goose/connect-stackone"}]}]},{"dropdown":"LangChain","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/langchain.svg","description":"LangSmith Fleet","groups":[{"group":"LangChain","pages":[{"title":"LangChain","sidebarTitle":"Overview","href":"/ai-platforms/langchain/overview"}]},{"group":"LangSmith Fleet","pages":[{"title":"LangSmith Fleet - Connect StackOne","sidebarTitle":"User Setup","href":"/ai-platforms/langchain/langsmith-fleet/user-setup"}]}]},{"dropdown":"Microsoft","icon":"microsoft","description":"GitHub Copilot and Microsoft 365 Copilot","groups":[{"group":"Microsoft","pages":[{"title":"Microsoft","sidebarTitle":"Overview","href":"/ai-platforms/microsoft/overview"}]},{"group":"GitHub Copilot","pages":[{"title":"GitHub Copilot CLI - Connect StackOne","sidebarTitle":"Copilot CLI User Setup","href":"/ai-platforms/microsoft/github-copilot/copilot-cli"},{"title":"GitHub Copilot in VS Code - Connect StackOne","sidebarTitle":"VS Code User Setup","href":"/ai-platforms/microsoft/github-copilot/vs-code"}]},{"group":"Microsoft 365 Copilot","pages":[{"title":"Microsoft 365 Copilot - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/microsoft/microsoft-365-copilot/connect-stackone"}]}]},{"dropdown":"n8n","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/mcp/logos/n8n.png","description":"n8n workflows","groups":[{"group":"n8n","pages":[{"title":"n8n","sidebarTitle":"Overview","href":"/ai-platforms/n8n/overview"},{"title":"n8n - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/n8n/connect-stackone"}]}]},{"dropdown":"OpenAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/stackone-60/images/agents/openai-logo.svg","description":"ChatGPT and Codex","groups":[{"group":"OpenAI","pages":[{"title":"OpenAI","sidebarTitle":"Overview","href":"/ai-platforms/openai/overview"}]},{"group":"ChatGPT","pages":[{"title":"ChatGPT - Make StackOne Available","sidebarTitle":"Organization Admin Setup","href":"/ai-platforms/openai/chatgpt/organization-admin-setup"},{"title":"ChatGPT - Connect StackOne","sidebarTitle":"Organization User Setup","href":"/ai-platforms/openai/chatgpt/organization-user-setup"},{"title":"ChatGPT - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/openai/chatgpt/personal-setup"}]},{"group":"Codex","pages":[{"title":"Codex - Connect StackOne","sidebarTitle":"Personal Setup","href":"/ai-platforms/openai/codex/connect-stackone"}]}]}]},{"tab":"Connectors","icon":"plug","pages":[{"title":"Connectors","href":"/connectors/introduction"}]},{"tab":"Embed","icon":"cube","pages":[{"title":"Embed","href":"/embed/overview"}]},{"tab":"Platform API","icon":"code","groups":[{"group":"Overview","root":{"title":"Platform API Reference","href":"/platform-api/overview"},"expanded":true,"pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/platform-api/authentication"},{"group":"Request Parameters","pages":[{"title":"Pagination","href":"/platform-api/request-parameters/pagination"},{"title":"Filtering","href":"/platform-api/request-parameters/filtering"},{"title":"Expanding Fields","href":"/platform-api/request-parameters/expanding-fields"}]},{"title":"Rate Limiting","href":"/platform-api/rate-limiting"},{"title":"Platform Events","sidebarTitle":"Platform Events","href":"/platform-api/platform-events"},{"title":"API SDKs","href":"/platform-api/api-sdks"}]},{"group":"Accounts","icon":"users","expanded":true,"pages":[{"openapi":"get /v2/accounts","title":"List accounts","href":"/platform/api-reference/v2/accounts/list-accounts"},{"openapi":"get /v2/accounts/filters","title":"List account filter values","href":"/platform/api-reference/v2/accounts/list-account-filter-values"},{"openapi":"get /v2/accounts/{id}","title":"Get an account","href":"/platform/api-reference/v2/accounts/get-an-account"},{"openapi":"patch /v2/accounts/{id}","title":"Patch an account","href":"/platform/api-reference/v2/accounts/patch-an-account"},{"openapi":"delete /v2/accounts/{id}","title":"Delete an account","description":"Deletes the account.","href":"/platform/api-reference/v2/accounts/delete-an-account"}]},{"group":"Actions","icon":"bolt","expanded":true,"pages":[{"openapi":"post /actions/search","title":"Search connector actions by semantic similarity","href":"/platform/api-reference/actions/search-connector-actions-by-semantic-similarity"},{"openapi":"post /actions/rpc","title":"Make an RPC call to an action","description":"Makes a remote procedure call to the specified action","href":"/platform/api-reference/actions/make-an-rpc-call-to-an-action"},{"openapi":"post /actions/rpc/synced","title":"Read synced action data from the datasync index","href":"/platform/api-reference/actions/read-synced-action-data-from-the-datasync-index"},{"openapi":"post /actions/rpc/synced/queryable_fields","title":"List the fields a synced action's data can be queried by","href":"/platform/api-reference/actions/list-the-fields-a-synced-actions-data-can-be-queried-by"},{"openapi":"post /unified/check_permissions","title":"Check user permissions on a resource","href":"/platform/api-reference/actions/check-user-permissions-on-a-resource"}]},{"group":"Connect Sessions","icon":"link","expanded":true,"pages":[{"openapi":"post /connect_sessions","title":"Create Connect Session","href":"/platform/api-reference/connect-sessions/create-connect-session"},{"openapi":"get /connect_sessions/{id}","title":"Get Connect Session","href":"/platform/api-reference/connect-sessions/get-connect-session"},{"openapi":"post /connect_sessions/authenticate","title":"Authenticate Connect Session","href":"/platform/api-reference/connect-sessions/authenticate-connect-session"}]},{"group":"Connector Profiles","icon":"sliders","expanded":true,"pages":[{"openapi":"get /v2/connector_profiles","title":"List connector profiles","href":"/platform/api-reference/v2/connector-profiles/list-connector-profiles"},{"openapi":"get /v2/connector_profiles/{id}","title":"Get a connector profile","href":"/platform/api-reference/v2/connector-profiles/get-a-connector-profile"},{"openapi":"post /v2/connector_profiles","title":"Create a connector profile","href":"/platform/api-reference/v2/connector-profiles/create-a-connector-profile"},{"openapi":"patch /v2/connector_profiles/{id}","title":"Patch a connector profile","href":"/platform/api-reference/v2/connector-profiles/patch-a-connector-profile"},{"openapi":"delete /v2/connector_profiles/{id}","title":"Delete a connector profile","href":"/platform/api-reference/v2/connector-profiles/delete-a-connector-profile"}]},{"group":"Connectors","icon":"puzzle-piece","expanded":true,"pages":[{"openapi":"get /v2/connectors","title":"List connectors","href":"/platform/api-reference/v2/connectors/list-connectors"},{"openapi":"get /v2/connectors/{id}","title":"Get connector","href":"/platform/api-reference/v2/connectors/get-connector"},{"openapi":"get /v2/connectors/{id}/source","title":"Get connector source","href":"/platform/api-reference/v2/connectors/get-connector-source"},{"openapi":"get /v2/connectors/{id}/actions/{actionId}","title":"Get connector action","href":"/platform/api-reference/v2/connectors/get-connector-action"},{"openapi":"get /v2/connectors/{id}/event_actions/{eventId}","title":"Get connector event action","href":"/platform/api-reference/v2/connectors/get-connector-event-action"},{"openapi":"get /v2/connectors/{id}/versions","title":"List connector versions","href":"/platform/api-reference/v2/connectors/list-connector-versions"},{"openapi":"post /v2/connectors","title":"Create a connector","href":"/platform/api-reference/v2/connectors/create-a-connector"},{"openapi":"post /v2/connectors/{id}/action_refreshes","title":"Create a connector action refresh","href":"/platform/api-reference/v2/connectors/create-a-connector-action-refresh"},{"openapi":"delete /v2/connectors/{id}","title":"Delete a connector","href":"/platform/api-reference/v2/connectors/delete-a-connector"}]},{"group":"Data Sync","icon":"rotate","expanded":true,"pages":[{"group":"Sync Configs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/sync_configs","title":"List sync configs","href":"/platform/api-reference/v2/data-sync/list-sync-configs"},{"openapi":"get /v2/data_sync/sync_configs/{id}","title":"Get a sync config","href":"/platform/api-reference/v2/data-sync/get-a-sync-config"},{"openapi":"get /v2/data_sync/sync_configs/{id}/parameters","title":"Get a sync config action's parameters","href":"/platform/api-reference/v2/data-sync/get-a-sync-config-actions-parameters"},{"openapi":"post /v2/data_sync/sync_configs","title":"Create a sync config","href":"/platform/api-reference/v2/data-sync/create-a-sync-config"},{"openapi":"patch /v2/data_sync/sync_configs/{id}","title":"Patch a sync config","href":"/platform/api-reference/v2/data-sync/patch-a-sync-config"},{"openapi":"delete /v2/data_sync/sync_configs/{id}","title":"Delete a sync config","href":"/platform/api-reference/v2/data-sync/delete-a-sync-config"}]},{"group":"Schedules","expanded":true,"pages":[{"openapi":"get /v2/data_sync/schedules","title":"List schedules","href":"/platform/api-reference/v2/data-sync/list-schedules"},{"openapi":"get /v2/data_sync/schedules/{id}","title":"Get a schedule","href":"/platform/api-reference/v2/data-sync/get-a-schedule"},{"openapi":"patch /v2/data_sync/schedules/{id}","title":"Patch a schedule","href":"/platform/api-reference/v2/data-sync/patch-a-schedule"}]},{"group":"Runs","expanded":true,"pages":[{"openapi":"get /v2/data_sync/runs","title":"List runs","href":"/platform/api-reference/v2/data-sync/list-runs"},{"openapi":"get /v2/data_sync/runs/{id}","title":"Get a run","href":"/platform/api-reference/v2/data-sync/get-a-run"}]}]},{"group":"Logs","icon":"file-lines","expanded":true,"pages":[{"openapi":"post /logs","title":"List Logs","href":"/platform/api-reference/logs/list-logs"},{"openapi":"post /logs/platform","title":"List Platform Logs","href":"/platform/api-reference/logs/list-platform-logs"},{"openapi":"post /logs/provider","title":"List Provider Logs","href":"/platform/api-reference/logs/list-provider-logs"},{"group":"Action Logs","expanded":true,"pages":[{"openapi":"post /logs/actions","title":"List Action Logs","href":"/platform/api-reference/logs/list-action-logs"},{"openapi":"get /logs/actions/{actionRunId}","title":"Get Action Log","href":"/platform/api-reference/logs/get-action-log"},{"openapi":"get /logs/actions/{actionRunId}/advanced","title":"Get Action Advanced Log","href":"/platform/api-reference/logs/get-action-advanced-log"},{"openapi":"get /logs/actions/{actionRunId}/defender","title":"Get Action Defender Log","href":"/platform/api-reference/logs/get-action-defender-log"}]},{"group":"Step Logs","expanded":true,"pages":[{"openapi":"post /logs/steps","title":"List Step Logs","href":"/platform/api-reference/logs/list-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps","title":"List Action Step Logs","href":"/platform/api-reference/logs/list-action-step-logs"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}","title":"Get Step Log","href":"/platform/api-reference/logs/get-step-log"},{"openapi":"get /logs/actions/{actionRunId}/steps/{stepIndex}/advanced","title":"Get Step Advanced Log","href":"/platform/api-reference/logs/get-step-advanced-log"}]},{"group":"Stats","expanded":true,"pages":[{"openapi":"post /logs/stats/aggregate","title":"Get Logs Stats Aggregate","href":"/platform/api-reference/logs/get-logs-stats-aggregate"},{"openapi":"post /logs/stats/dimensions","title":"Get Logs Stats Dimensions","href":"/platform/api-reference/logs/get-logs-stats-dimensions"}]}]},{"group":"MCP","icon":"plug","expanded":true,"pages":[{"openapi":"post /mcp","title":"Send MCP JSON-RPC message","href":"/platform/api-reference/mcp/send-mcp-json-rpc-message"}]},{"group":"Webhooks","icon":"webhook","expanded":true,"pages":[{"openapi":"get /v2/webhooks","title":"List webhooks","href":"/platform/api-reference/v2/webhooks/list-webhooks"},{"openapi":"get /v2/webhooks/{id}","title":"Get a webhook","href":"/platform/api-reference/v2/webhooks/get-a-webhook"},{"openapi":"post /v2/webhooks","title":"Create a webhook","href":"/platform/api-reference/v2/webhooks/create-a-webhook"},{"openapi":"patch /v2/webhooks/{id}","title":"Update a webhook","href":"/platform/api-reference/v2/webhooks/update-a-webhook"},{"openapi":"delete /v2/webhooks/{id}","title":"Delete a webhook","href":"/platform/api-reference/v2/webhooks/delete-a-webhook"},{"openapi":"post /v2/webhooks/events","title":"Send webhook events","href":"/platform/api-reference/v2/webhooks/send-webhook-events"}]}]}]},"basePath":"","title":"Search connector actions by semantic similarity - Stackone","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}