API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.
For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected IDs in the response always identify leaf channels, regardless of which level is queried.
True while the provider's channel list is being walked in the background (large workspaces can take a minute) — poll again shortly; channels is empty and NOT the workspace's real state while pending.
True when the workspace has more channels than could be listed, so channels is incomplete. A saved non-empty selection indexes only the channels it contains, so channels that were not listed stop being indexed.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Hyperspell","colors":{"primary":"#eF7E75","light":"#eF7E75","dark":"#FF7E75"},"logo":{"light":"https://mintcdn.com/hyperspell/v3b7lBADAA2jgsr8/logo/light.svg?fit=max\u0026auto=format\u0026n=v3b7lBADAA2jgsr8\u0026q=85\u0026s=daa1192bf1d8015701d50d2c12b5e843","dark":"https://mintcdn.com/hyperspell/v3b7lBADAA2jgsr8/logo/dark.svg?fit=max\u0026auto=format\u0026n=v3b7lBADAA2jgsr8\u0026q=85\u0026s=f902d22b6c72a38457450091a65af5b1","href":"https://hyperspell.com"},"favicon":"https://mintcdn.com/hyperspell/v3b7lBADAA2jgsr8/favicon.svg?fit=max\u0026auto=format\u0026n=v3b7lBADAA2jgsr8\u0026q=85\u0026s=e3868fcf92af7815460b8dc73c41e908","appearance":{"default":"light"},"background":{"decoration":"gradient","color":{"light":"#f9f9f9","dark":"#151313"}},"navbar":{"links":[{"href":"mailto:hello@hyperspell.com","label":"Support"},{"href":"https://hyperspell.com/blog","label":"Blog"}],"primary":{"type":"button","label":"Open Dashboard","href":"https://app.hyperspell.com"}},"footer":{"socials":{"x":"https://x.com/hyperspell","github":"https://github.com/hyperspell","linkedin":"https://linkedin.com/company/hyperspell"}},"fonts":{"heading":{"family":"Exposure","weight":400,"source":"fonts/exposure.woff2","format":"woff2"},"body":{"family":"Geist"}},"integrations":{"plausible":{"domain":"docs.hyperspell.com"}},"contextual":{"options":["copy","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hyperspell","hasAudioNarration":false,"actualSubdomain":"hyperspell","customDomains":["docs.hyperspell.com"],"gitSource":{"type":"github","owner":"hyperspell","repo":"hyperspell","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae517fd1a4da1e67ff76404","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":69},{"language":"default","tag":"Integrations","count":68},{"language":"default","tag":"Documentation","count":18},{"language":"default","tag":"Memories","count":18},{"language":"default","tag":"Connecting Agents","count":9},{"language":"default","tag":"Resources","count":4},{"language":"default","tag":"Emotional State","count":4},{"language":"default","tag":"Evaluation","count":4},{"language":"default","tag":"Folder Policies","count":4},{"language":"default","tag":"Live","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/integrations/list-available-channels","slug":"/api-reference/integrations/list-available-channels","pageMetadata":{"title":"List available channels","description":"List available channels/chats for a connected integration.\n\nAlso returns the connection's currently selected channel IDs.","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/{integration_id}/channels","href":"/api-reference/integrations/list-available-channels","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"List available channels/chats for a connected integration.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Also returns the connection’s currently selected channel IDs.\"\n })]\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":"List available channels","description":"List available channels/chats for a connected integration.\n\nAlso returns the connection's currently selected channel IDs.","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/{integration_id}/channels","href":"/api-reference/integrations/list-available-channels","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Integrations","Integrations"],"summary":"List available channels","description":"List available channels/chats for a connected integration.\n\nAlso returns the connection's currently selected channel IDs.","operationId":"list_channels_integrations__integration_id__channels_get","security":["f745d4b6-a429-470e-b8b5-3899a43fca1c"],"parameters":["0b164921-c508-4279-977b-6f5296a246c6","31879d57-ba05-49eb-8726-fa4c8567d7a5","439f2d38-e25c-40f3-ae53-4cd881f722e2","45645c2f-0282-4a71-aa25-03d7250c5e1f"],"responses":{"200":"fc6eeea9-6a2c-42cb-9954-4b52f42c76a7","422":"22d4dbd6-f34a-41ef-acf8-cc62e9abb79b"},"method":"get","type":"path","servers":["33b89f8f-bc4a-455c-9dbb-359f6257c898"],"path":"/integrations/{integration_id}/channels","baseUrlOptions":["https://api.hyperspell.com"],"title":"List available channels","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0b164921-c508-4279-977b-6f5296a246c6":{"name":"integration_id","in":"path","required":true,"schema":{"type":"string","title":"Integration Id","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"31879d57-ba05-49eb-8726-fa4c8567d7a5":{"name":"connection_id","in":"query","required":true,"schema":{"type":"string","description":"The connection ID to use for listing channels","title":"Connection Id","isRequired":true,"uniqueKey":"","typeLabel":"string"},"description":"The connection ID to use for listing channels"},"439f2d38-e25c-40f3-ae53-4cd881f722e2":{"name":"parent_id","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Parent Id","description":"For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected IDs in the response always identify leaf channels, regardless of which level is queried.","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Parent Id","description":"For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected IDs in the response always identify leaf channels, regardless of which level is queried.","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"For hierarchical providers (e.g. Microsoft Teams): omit to list root containers (workspaces); pass a container's id to list its children (sub-channels). Selected IDs in the response always identify leaf channels, regardless of which level is queried."},"45645c2f-0282-4a71-aa25-03d7250c5e1f":{"name":"X-As-User","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-As-User","description":"Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-As-User","description":"Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Optionally set this header to act as a specific user when using an API Key, equivalent to first exchanging the API Key for a User Token"}},"responses":{"fc6eeea9-6a2c-42cb-9954-4b52f42c76a7":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"channels":{"items":{"properties":{"id":{"type":"string","title":"Id","isRequired":true,"uniqueKey":"channels.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","title":"Name","isRequired":true,"uniqueKey":"channels.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","title":"Type","default":"channel","uniqueKey":"channels.items.[INDEX].type","typeLabel":"string"}},"type":"object","required":["id","name"],"title":"ChannelInfo","description":"A selectable channel/chat from an integration provider.","uniqueKey":"channels.items.[INDEX]","typeLabel":"ChannelInfo · object"},"type":"array","title":"Channels","isRequired":true,"uniqueKey":"channels","typeLabel":"ChannelInfo · object[]"},"selected":{"items":{"type":"string","uniqueKey":"selected.items.[INDEX]","typeLabel":"string"},"type":"array","title":"Selected","description":"IDs currently selected for indexing.","uniqueKey":"selected","typeLabel":"string[]"},"pending":{"type":"boolean","title":"Pending","description":"True while the provider's channel list is being walked in the background (large workspaces can take a minute) — poll again shortly; channels is empty and NOT the workspace's real state while pending.","default":false,"uniqueKey":"pending","typeLabel":"boolean"},"truncated":{"type":"boolean","title":"Truncated","description":"True when the workspace has more channels than could be listed, so channels is incomplete. A saved non-empty selection indexes only the channels it contains, so channels that were not listed stop being indexed.","default":false,"uniqueKey":"truncated","typeLabel":"boolean"}},"type":"object","required":["channels"],"title":"ListChannelsResponse","uniqueKey":"","typeLabel":"ListChannelsResponse · object"},"examples":{"Example":{"title":"Example","value":{"channels":[{"id":"\u003cstring>","name":"\u003cstring>","type":"channel"}],"selected":["\u003cstring>"],"pending":false,"truncated":false}}},"exampleType":"generated"}},"exampleType":"generated"},"22d4dbd6-f34a-41ef-acf8-cc62e9abb79b":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f745d4b6-a429-470e-b8b5-3899a43fca1c":{"APIKey":{"type":"http","description":"API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.","scheme":"bearer","bearerFormat":"Bearer \u003ctoken>","scopes":[],"schemeName":"APIKey"}}},"servers":{"33b89f8f-bc4a-455c-9dbb-359f6257c898":{"url":"https://api.hyperspell.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","description":"API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.","scheme":"bearer","bearerFormat":"Bearer \u003ctoken>","scopes":[],"schemeName":"APIKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API Key or JWT User Token. If using an API Key, set the X-As-User header to act as a specific user. A JWT User Token is always scoped to a specific user.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"APIKey","name":"Authorization"}],"title":"APIKey"}]},"originalFileLocation":"https://api.hyperspell.com/openapi.json"},"subdomain":"hyperspell","siteName":"Hyperspell","title":"List available channels - Hyperspell","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T22:19:46.727Z","originalFileLocation":"api-reference/integrations/list-available-channels.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=\"List available channels/chats for a connected integration. Also returns the connection\u0026#x27;s currently selected channel IDs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hyperspell\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_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/hyperspell/_L3SAE3y_mnPfj1R/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List available channels - Hyperspell\">\u003cmeta data-mint-head property=\"og:description\" content=\"List available channels/chats for a connected integration. Also returns the connection\u0026#x27;s currently selected channel IDs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Hyperspell\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hyperspell.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=List+available+channels\u0026amp;description=List+available+channels%2Fchats+for+a+connected+integration.%0A%0AAlso+returns+the+connection%27s+currently+selected+channel+IDs.\u0026amp;theme=86c00e641f3576d5ee8834df\u0026amp;signature=2289f7aa02299b96aa0437c8070d6b448a682659e505bcd6dc89a98dbdbdf6dc\">\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=\"List available channels - Hyperspell\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List available channels/chats for a connected integration. Also returns the connection\u0026#x27;s currently selected channel IDs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hyperspell.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=List+available+channels\u0026amp;description=List+available+channels%2Fchats+for+a+connected+integration.%0A%0AAlso+returns+the+connection%27s+currently+selected+channel+IDs.\u0026amp;theme=86c00e641f3576d5ee8834df\u0026amp;signature=2289f7aa02299b96aa0437c8070d6b448a682659e505bcd6dc89a98dbdbdf6dc\">\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/hyperspell/_L3SAE3y_mnPfj1R/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Hyperspell\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#eF7E75\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/integrations/list-available-channels.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.hyperspell.com/#organization\",\"name\":\"Hyperspell\",\"url\":\"https://docs.hyperspell.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hyperspell/v3b7lBADAA2jgsr8/logo/light.svg?fit=max\u0026auto=format\u0026n=v3b7lBADAA2jgsr8\u0026q=85\u0026s=daa1192bf1d8015701d50d2c12b5e843\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.hyperspell.com#website\",\"name\":\"Hyperspell\",\"url\":\"https://docs.hyperspell.com\",\"publisher\":{\"@id\":\"https://docs.hyperspell.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels#webpage\",\"url\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels\",\"name\":\"List available channels\",\"description\":\"List available channels/chats for a connected integration. Also returns the connection's currently selected channel IDs.\",\"dateModified\":\"2026-10-30T22:19:46.727Z\",\"isPartOf\":{\"@id\":\"https://docs.hyperspell.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Integrations\",\"item\":\"https://docs.hyperspell.com/api-reference/integrations/list-all-integrations\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List available channels\",\"item\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels#apireference\",\"headline\":\"List available channels\",\"name\":\"List available channels\",\"description\":\"List available channels/chats for a connected integration. Also returns the connection's currently selected channel IDs.\",\"url\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels\",\"mainEntityOfPage\":{\"@id\":\"https://docs.hyperspell.com/api-reference/integrations/list-available-channels#webpage\"},\"dateModified\":\"2026-10-30T22:19:46.727Z\",\"publisher\":{\"@id\":\"https://docs.hyperspell.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.hyperspell.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Hyperspell\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Hyperspell","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/core/introduction"}]},{"anchor":"Integrations","icon":"circle-nodes","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"anchor":"API Reference","icon":"terminal","groups":[{"group":"API Documentation","pages":[{"title":"API Introduction","href":"/api-reference/introduction"}]},{"group":"Memories","pages":[{"title":"Add a memory only at the expected revision","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/conditional/add","href":"/api-reference/memories/add-a-memory-only-at-the-expected-revision"},{"title":"Add a memory","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/add","href":"/api-reference/memories/add-a-memory"},{"title":"Add multiple memories","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/add/bulk","href":"/api-reference/memories/add-multiple-memories"},{"title":"Update a Vault memory only at the expected revision","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/conditional/update/{resource_id}","href":"/api-reference/memories/update-a-vault-memory-only-at-the-expected-revision"},{"title":"Update a memory","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/update/{source}/{resource_id}","href":"/api-reference/memories/update-a-memory"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/upload","href":"/api-reference/memories/upload-a-file"},{"title":"List Sharing Requests","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/sharing/requests","href":"/api-reference/memories/list-sharing-requests"},{"title":"Decide Sharing Request","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/sharing/decide","href":"/api-reference/memories/decide-sharing-request"},{"title":"List Activity History","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/activity/history","href":"/api-reference/memories/list-activity-history"},{"title":"Get Activity Checkpoint","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/activity/checkpoints/{checkpoint_id}","href":"/api-reference/memories/get-activity-checkpoint"},{"title":"Request Activity Checkpoint Sharing","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/activity/checkpoints/{checkpoint_id}/sharing","href":"/api-reference/memories/request-activity-checkpoint-sharing"},{"title":"Query memories","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/query","href":"/api-reference/memories/query-memories"},{"title":"List memories","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/list","href":"/api-reference/memories/list-memories"},{"title":"Show indexing progress","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/status","href":"/api-reference/memories/show-indexing-progress"},{"title":"Get memory","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /memories/get/{source}/{resource_id}","href":"/api-reference/memories/get-memory"},{"title":"Delete memory","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json delete /memories/delete/{source}/{resource_id}","href":"/api-reference/memories/delete-memory"},{"title":"Approve a pending resource","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/approve/{source}/{resource_id}","href":"/api-reference/memories/approve-a-pending-resource"},{"title":"Reject a pending resource","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /memories/reject/{source}/{resource_id}","href":"/api-reference/memories/reject-a-pending-resource"}]},{"group":"Messages","pages":[{"title":"Ingest messages","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /messages","href":"/api-reference/messages/ingest-messages"}]},{"group":"Traces","pages":[{"title":"Add an agent trace","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /trace/add","href":"/api-reference/traces/add-an-agent-trace"}]},{"group":"Live","pages":[{"title":"List live-queryable sources","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /live/sources","href":"/api-reference/live/list-live-queryable-sources"},{"title":"List resources from a source live","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /live/{source}/resources","href":"/api-reference/live/list-resources-from-a-source-live"},{"title":"Fetch one resource live","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /live/{source}/resources/{resource_id}","href":"/api-reference/live/fetch-one-resource-live"},{"title":"Search a source live","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /live/{source}/search","href":"/api-reference/live/search-a-source-live"}]},{"group":"Evaluation","pages":[{"title":"Get query result","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /evaluate/query/{query_id}","href":"/api-reference/evaluation/get-query-result"},{"title":"Score a query result","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /evaluate/query/{query_id}","href":"/api-reference/evaluation/score-a-query-result"},{"title":"Score a highlight","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /evaluate/highlight/{highlight_id}","href":"/api-reference/evaluation/score-a-highlight"},{"title":"List prior queries","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /evaluate/queries","href":"/api-reference/evaluation/list-prior-queries"}]},{"group":"Authentication","pages":[{"title":"Get a user token","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /auth/user_token","href":"/api-reference/authentication/get-a-user-token"},{"title":"Get Basic user data","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /auth/me","href":"/api-reference/authentication/get-basic-user-data"},{"title":"Delete user","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json delete /auth/delete","href":"/api-reference/authentication/delete-user"}]},{"group":"Users","pages":[{"title":"List users","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /users","href":"/api-reference/users/list-users"}]},{"group":"Device Auth","pages":[{"title":"Device Login","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /auth/device-login","href":"/api-reference/device-auth/device-login"},{"title":"Device Poll","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /auth/device-poll","href":"/api-reference/device-auth/device-poll"}]},{"group":"Integrations","pages":[{"title":"List all integrations","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/list","href":"/api-reference/integrations/list-all-integrations"},{"title":"Link an integration","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/{integration_id}/connect","href":"/api-reference/integrations/link-an-integration"},{"title":"Update connection permissions","description":"Authorize additional Slack permissions without replaying historical data.\n\nThe existing personal connection, account, workspace and data are preserved.\nOpen the returned link immediately and finish consent within ten minutes of\nissuance. Opening the link does not extend its lifetime. No change occurs\nuntil approval.","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /integrations/{integration_id}/connections/{connection_id}/permissions","href":"/api-reference/integrations/update-connection-permissions"},{"title":"List available channels","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/{integration_id}/channels","href":"/api-reference/integrations/list-available-channels"},{"title":"Update per-connection user options (e.g., channel allowlist)","description":"Save per-user options on a connection owned by the authenticated user.\n\nConnections outside the current app cannot be updated.","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json patch /integrations/{integration_id}/connections/{connection_id}","href":"/api-reference/integrations/update-per-connection-user-options-eg-channel-allowlist"},{"title":"List indexed websites","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/websites","href":"/api-reference/integrations/list-indexed-websites"},{"title":"List indexed website pages","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/websites/pages","href":"/api-reference/integrations/list-indexed-website-pages"},{"title":"Read a website refresh schedule","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/schedule","href":"/api-reference/integrations/read-a-website-refresh-schedule"},{"title":"Set a website refresh schedule","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json put /integrations/web_crawler/schedule","href":"/api-reference/integrations/set-a-website-refresh-schedule"},{"title":"Refresh an indexed website","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /integrations/web_crawler/crawl/refresh","href":"/api-reference/integrations/refresh-an-indexed-website"},{"title":"Index a public website","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /integrations/web_crawler/crawl","href":"/api-reference/integrations/index-a-public-website"},{"title":"Read the latest website crawl progress","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/crawl/status","href":"/api-reference/integrations/read-the-latest-website-crawl-progress"},{"title":"Cancel a website crawl","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /integrations/web_crawler/crawl/cancel","href":"/api-reference/integrations/cancel-a-website-crawl"},{"title":"Remove an indexed website","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /integrations/web_crawler/websites/remove","href":"/api-reference/integrations/remove-an-indexed-website"},{"title":"Crawl a website for indexed search","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/index","href":"/api-reference/integrations/crawl-a-website-for-indexed-search"},{"title":"Check crawl status for a URL","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /integrations/web_crawler/status","href":"/api-reference/integrations/check-crawl-status-for-a-url"}]},{"group":"Connections","pages":[{"title":"List connections","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /connections/list","href":"/api-reference/connections/list-connections"},{"title":"Revoke connection","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json delete /connections/{connection_id}/revoke","href":"/api-reference/connections/revoke-connection"}]},{"group":"Folder Policies","pages":[{"title":"List folder policies for a connection","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /connections/{connection_id}/folder-policies","href":"/api-reference/folder-policies/list-folder-policies-for-a-connection"},{"title":"Batch-apply folder policies for a connection","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json put /connections/{connection_id}/folder-policies","href":"/api-reference/folder-policies/batch-apply-folder-policies-for-a-connection"},{"title":"Create a folder policy for a connection","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /connections/{connection_id}/folder-policies","href":"/api-reference/folder-policies/create-a-folder-policy-for-a-connection"},{"title":"Delete a folder policy","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json delete /connections/{connection_id}/folder-policies/{policy_id}","href":"/api-reference/folder-policies/delete-a-folder-policy"}]},{"group":"Folders","pages":[{"title":"List folders for a connection","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /connections/{connection_id}/folders","href":"/api-reference/folders/list-folders-for-a-connection"}]},{"group":"OAuth","pages":[{"title":"Issue a one-time exchange code for the current user JWT","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /oauth/token-exchange/issue","href":"/api-reference/oauth/issue-a-one-time-exchange-code-for-the-current-user-jwt"}]},{"group":"Vault","pages":[{"title":"List vaults","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /vault/list","href":"/api-reference/vault/list-vaults"}]},{"group":"Emotional State","pages":[{"title":"Get latest emotional state","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /emotional-state","href":"/api-reference/emotional-state/get-latest-emotional-state"},{"title":"Store emotional state","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /emotional-state","href":"/api-reference/emotional-state/store-emotional-state"},{"title":"Delete emotional state","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json delete /emotional-state","href":"/api-reference/emotional-state/delete-emotional-state"},{"title":"Get recent emotional states","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /emotional-state/recent","href":"/api-reference/emotional-state/get-recent-emotional-states"}]},{"group":"entities","pages":[{"title":"List Entities","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /entities","href":"/api-reference/entities/list-entities"},{"title":"Get Entity","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json get /entities/{entity_id}","href":"/api-reference/entities/get-entity"},{"title":"Search Entities","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /entities/search","href":"/api-reference/entities/search-entities"}]},{"group":"Actions","pages":[{"title":"Send a message","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /actions/send_message","href":"/api-reference/actions/send-a-message"},{"title":"Add a reaction","deprecated":null,"version":null,"openapi":"https://api.hyperspell.com/openapi.json post /actions/add_reaction","href":"/api-reference/actions/add-a-reaction"}]}]}]},"basePath":"","title":"List available channels - Hyperspell","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}