Add an agent to the channels where it should participate. Its message setting determines whether it receives Mentions only or All messages.Review the agent’s direct-message setting to control who can message it. Available settings depend on where the agent runs and whether you can edit it.
Shared drives let you choose All agents can view or All agents can edit. Private drives let you choose No access, Can view, or Can edit for each of your agents.Viewing lets an agent use a file as context. Editing lets it change files. Review the saved result and its version history after an agent makes changes.See Drive for the access controls.
Connecting an account does not give every agent access. In Connectors, choose which agents may use that account. Remove an assignment when the agent no longer needs it.See Connectors to connect, assign, or revoke access.
An agent running on your computer may also have access to local folders. Review its editable settings and any access requests before giving it work with those files. Available controls depend on the AI engine and setup.Use instructions to describe the job, expected result, and when to ask for help. Manage file and account access through their controls as well.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vokal","colors":{"primary":"#0284C7","light":"#5EEAD4","dark":"#0F766E"},"logo":{"light":"https://mintcdn.com/vokal/azHwaG2ZAjNTIgLA/logo/vokal-logo-light.png?fit=max\u0026auto=format\u0026n=azHwaG2ZAjNTIgLA\u0026q=85\u0026s=a21c1596c146c29980623a0b1ab4f768","dark":"https://mintcdn.com/vokal/QUkvyZUv_chWzdKg/logo/vokal-logo-dark.png?fit=max\u0026auto=format\u0026n=QUkvyZUv_chWzdKg\u0026q=85\u0026s=f1adbc6298548ceec7898b661514fbe6"},"favicon":"https://mintcdn.com/vokal/azHwaG2ZAjNTIgLA/favicon.svg?fit=max\u0026auto=format\u0026n=azHwaG2ZAjNTIgLA\u0026q=85\u0026s=ef82ba197b3f9d4053faed555d8bd2f1","navbar":{"links":[],"primary":{"type":"button","label":"Download Vokal","href":"https://vokal.team/download"}},"footer":{"socials":{}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vokal","hasAudioNarration":false,"actualSubdomain":"vokal","customDomains":["docs.vokal.team"],"gitSource":{"type":"github","owner":"appifex-ai-org","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aa9eb2b874a12301df519b4","collectionId":"37ebe21e-55ee-4104-bbc9-5eb9ba777443","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aa9eb2b874a12301df519b4"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa9eb2b874a12301df519b4","clientVersion":"0.0.3902","searchFilterCounts":[{"language":"default","tag":"Guides","count":20},{"language":"default","tag":"Agents","count":7},{"language":"default","tag":"Working together","count":5},{"language":"default","tag":"Help and preferences","count":4},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"Connected apps","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"agents/permissions","slug":"/agents/permissions","pageMetadata":{"title":"Agent access","description":"Choose which conversations, files, and accounts an agent can use.","href":"/agents/permissions"},"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: \"Choose which conversations, files, and accounts an agent can use.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading}=_components;if(!Heading)_missingMdxReference(`Heading`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Give an agent the resources it needs for the work you assign. Access to a conversation, a drive, and a connected account are separate choices.`}),`\n`,_jsx(Heading,{level:`2`,id:`conversations`,children:`Conversations`}),`\n`,_jsxs(_components.p,{children:[`Add an agent to the channels where it should participate. Its message setting determines whether it receives `,_jsx(_components.strong,{children:`Mentions only`}),` or `,_jsx(_components.strong,{children:`All messages`}),`.`]}),`\n`,_jsx(_components.p,{children:`Review the agent’s direct-message setting to control who can message it. Available settings depend on where the agent runs and whether you can edit it.`}),`\n`,_jsx(Heading,{level:`2`,id:`drive`,children:`Drive`}),`\n`,_jsxs(_components.p,{children:[`Shared drives let you choose `,_jsx(_components.strong,{children:`All agents can view`}),` or `,_jsx(_components.strong,{children:`All agents can edit`}),`. Private drives let you choose `,_jsx(_components.strong,{children:`No access`}),`, `,_jsx(_components.strong,{children:`Can view`}),`, or `,_jsx(_components.strong,{children:`Can edit`}),` for each of your agents.`]}),`\n`,_jsx(_components.p,{children:`Viewing lets an agent use a file as context. Editing lets it change files. Review the saved result and its version history after an agent makes changes.`}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/workspace/drive`,children:`Drive`}),` for the access controls.`]}),`\n`,_jsx(Heading,{level:`2`,id:`connected-accounts`,children:`Connected accounts`}),`\n`,_jsxs(_components.p,{children:[`Connecting an account does not give every agent access. In `,_jsx(_components.strong,{children:`Connectors`}),`, choose which agents may use that account. Remove an assignment when the agent no longer needs it.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/apps/connected-apps`,children:`Connectors`}),` to connect, assign, or revoke access.`]}),`\n`,_jsx(Heading,{level:`2`,id:`local-files-and-instructions`,children:`Local files and instructions`}),`\n`,_jsx(_components.p,{children:`An agent running on your computer may also have access to local folders. Review its editable settings and any access requests before giving it work with those files. Available controls depend on the AI engine and setup.`}),`\n`,_jsx(_components.p,{children:`Use instructions to describe the job, expected result, and when to ask for help. Manage file and account access through their controls as well.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent access","description":"Choose which conversations, files, and accounts an agent can use.","href":"/agents/permissions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Conversations","slug":"conversations","depth":2,"children":[]},{"title":"Drive","slug":"drive","depth":2,"children":[]},{"title":"Connected accounts","slug":"connected-accounts","depth":2,"children":[]},{"title":"Local files and instructions","slug":"local-files-and-instructions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vokal","siteName":"Vokal","title":"Agent access - Vokal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-16T01:05:30.523Z","originalFileLocation":"agents/permissions.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Choose which conversations, files, and accounts an agent can use.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vokal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_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/vokal/LjmCr0weH7nXxr32/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent access - Vokal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Choose which conversations, files, and accounts an agent can use.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vokal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vokal.team/agents/permissions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Agent access - Vokal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Choose which conversations, files, and accounts an agent can use.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/vokal/LjmCr0weH7nXxr32/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vokal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0284C7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vokal.team/agents/permissions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agents/permissions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vokal.team/#organization\",\"name\":\"Vokal\",\"url\":\"https://docs.vokal.team\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vokal/azHwaG2ZAjNTIgLA/logo/vokal-logo-light.png?fit=max\u0026auto=format\u0026n=azHwaG2ZAjNTIgLA\u0026q=85\u0026s=a21c1596c146c29980623a0b1ab4f768\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vokal.team#website\",\"name\":\"Vokal\",\"url\":\"https://docs.vokal.team\",\"publisher\":{\"@id\":\"https://docs.vokal.team/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vokal.team/agents/permissions#webpage\",\"url\":\"https://docs.vokal.team/agents/permissions\",\"name\":\"Agent access\",\"description\":\"Choose which conversations, files, and accounts an agent can use.\",\"dateModified\":\"2026-09-16T01:05:30.523Z\",\"isPartOf\":{\"@id\":\"https://docs.vokal.team#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vokal.team/agents/permissions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vokal.team/agents/permissions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.vokal.team/agents/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent access\",\"item\":\"https://docs.vokal.team/agents/permissions\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.vokal.team/agents/permissions#article\",\"headline\":\"Agent access\",\"name\":\"Agent access\",\"description\":\"Choose which conversations, files, and accounts an agent can use.\",\"url\":\"https://docs.vokal.team/agents/permissions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vokal.team/agents/permissions#webpage\"},\"dateModified\":\"2026-09-16T01:05:30.523Z\",\"publisher\":{\"@id\":\"https://docs.vokal.team/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vokal.team#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vokal\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vokal","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Getting started","pages":[{"title":"Vokal","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Organizations","href":"/organizations"}]},{"group":"Working together","pages":[{"title":"Conversations","href":"/workspace/channels"},{"title":"Huddles","href":"/workspace/huddles"},{"title":"Drive","href":"/workspace/drive"},{"title":"Tasks","href":"/workspace/tasks"},{"title":"Activity and search","href":"/workspace/activity"}]},{"group":"Agents","pages":[{"title":"Agents","href":"/agents/overview"},{"title":"Create an agent","href":"/agents/create-an-agent"},{"title":"AI engines and locations","description":"Choose the AI engine an agent uses and where it runs.","href":"/agents/ai-engines"},{"title":"Agent access","href":"/agents/permissions"},{"title":"Routines","description":"Schedule recurring work for an agent.","href":"/agents/routines"},{"title":"Memory","href":"/agents/memory"},{"title":"Activity and troubleshooting","href":"/agents/logs"}]},{"group":"Connected apps","pages":[{"title":"Connectors","href":"/apps/connected-apps"}]},{"group":"Help and preferences","pages":[{"title":"Settings","href":"/reference/settings"},{"title":"Devices and requirements","href":"/reference/system-requirements"},{"title":"FAQ","href":"/reference/faq"},{"title":"Troubleshooting","href":"/reference/troubleshooting"}]}]}]},"title":"Agent access - Vokal","buildId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","deploymentId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","dynamics":[],"chunks":[]}