[{"data":1,"prerenderedAt":449},["ShallowReactive",2],{"navigation":3,"/connect-your-tools/secrets":200,"/connect-your-tools/secrets-surround":444},[4,22,50,83,120,156,189],{"title":5,"path":6,"stem":7,"children":8,"icon":16},"Getting Started","/getting-started","1.getting-started/1.index",[9,12,17],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-ph-house",{"title":13,"path":14,"stem":15,"icon":16},"Quickstart","/getting-started/quickstart","1.getting-started/2.quickstart","i-ph-rocket",{"title":18,"path":19,"stem":20,"icon":21},"Plans","/getting-started/plans","1.getting-started/3.plans","i-ph-credit-card",{"title":23,"path":24,"stem":25,"children":26,"icon":29},"Agents","/agents","2.agents/1.index",[27,30,35,40,45],{"title":28,"path":24,"stem":25,"icon":29},"Overview","i-ph-robot",{"title":31,"path":32,"stem":33,"icon":34},"Creating an agent","/agents/creating-an-agent","2.agents/2.creating-an-agent","i-ph-plus",{"title":36,"path":37,"stem":38,"icon":39},"Agent settings","/agents/settings","2.agents/3.settings","i-ph-gear",{"title":41,"path":42,"stem":43,"icon":44},"Memory","/agents/memory","2.agents/4.memory","i-ph-database",{"title":46,"path":47,"stem":48,"icon":49},"Residential proxy","/agents/proxy","2.agents/5.proxy","i-ph-globe-hemisphere-west",{"title":51,"path":52,"stem":53,"children":54,"icon":57},"Chats & Tasks","/chats-and-tasks","3.chats-and-tasks/1.index",[55,58,63,68,73,78],{"title":56,"path":52,"stem":53,"icon":57},"Chats","i-ph-chats-circle",{"title":59,"path":60,"stem":61,"icon":62},"Sharing chats","/chats-and-tasks/sharing-chats","3.chats-and-tasks/2.sharing-chats","i-ph-share-network",{"title":64,"path":65,"stem":66,"icon":67},"Tasks","/chats-and-tasks/tasks","3.chats-and-tasks/3.tasks","i-ph-list-checks",{"title":69,"path":70,"stem":71,"icon":72},"Recurring tasks","/chats-and-tasks/recurring-tasks","3.chats-and-tasks/4.recurring-tasks","i-ph-repeat",{"title":74,"path":75,"stem":76,"icon":77},"Results & deliverables","/chats-and-tasks/results-and-deliverables","3.chats-and-tasks/5.results-and-deliverables","i-ph-package",{"title":79,"path":80,"stem":81,"icon":82},"Save a chat as a skill","/chats-and-tasks/save-chat-as-skill","3.chats-and-tasks/6.save-chat-as-skill","i-ph-sparkle",{"title":84,"path":85,"stem":86,"children":87,"icon":90},"Models & Skills","/models-and-skills","4.models-and-skills/1.index",[88,91,96,101,105,110,115],{"title":89,"path":85,"stem":86,"icon":90},"LLM configuration","i-ph-cpu",{"title":92,"path":93,"stem":94,"icon":95},"Providers & models","/models-and-skills/providers","4.models-and-skills/2.providers","i-ph-stack",{"title":97,"path":98,"stem":99,"icon":100},"Bring your own key","/models-and-skills/byok","4.models-and-skills/3.byok","i-ph-key",{"title":102,"path":103,"stem":104,"icon":29},"ChatGPT subscription","/models-and-skills/chatgpt-subscription","4.models-and-skills/4.chatgpt-subscription",{"title":106,"path":107,"stem":108,"icon":109},"Skills","/models-and-skills/skills","4.models-and-skills/5.skills","i-ph-puzzle-piece",{"title":111,"path":112,"stem":113,"icon":114},"Installing skills","/models-and-skills/installing-skills","4.models-and-skills/6.installing-skills","i-ph-download-simple",{"title":116,"path":117,"stem":118,"icon":119},"Custom skills","/models-and-skills/custom-skills","4.models-and-skills/7.custom-skills","i-ph-code",{"title":121,"path":122,"stem":123,"children":124,"icon":126},"Connect Your Tools","/connect-your-tools","5.connect-your-tools/1.index",[125,127,132,137,142,147,151],{"title":28,"path":122,"stem":123,"icon":126},"i-ph-plug",{"title":128,"path":129,"stem":130,"icon":131},"Telegram","/connect-your-tools/telegram","5.connect-your-tools/2.telegram","i-ph-telegram-logo",{"title":133,"path":134,"stem":135,"icon":136},"Discord","/connect-your-tools/discord","5.connect-your-tools/3.discord","i-ph-discord-logo",{"title":138,"path":139,"stem":140,"icon":141},"Slack","/connect-your-tools/slack","5.connect-your-tools/4.slack","i-ph-slack-logo",{"title":143,"path":144,"stem":145,"icon":146},"Connectors","/connect-your-tools/connectors","5.connect-your-tools/5.connectors","i-ph-link",{"title":148,"path":149,"stem":150,"icon":100},"Secrets","/connect-your-tools/secrets","5.connect-your-tools/6.secrets",{"title":152,"path":153,"stem":154,"icon":155},"Audit log","/connect-your-tools/secret-audit-log","5.connect-your-tools/7.secret-audit-log","i-ph-scroll",{"title":157,"path":158,"stem":159,"children":160,"icon":188},"Account & Team","/account-and-team","6.account-and-team/1.index",[161,164,169,174,179,183],{"title":162,"path":158,"stem":159,"icon":163},"Signing in","i-ph-sign-in",{"title":165,"path":166,"stem":167,"icon":168},"Team members","/account-and-team/teams","6.account-and-team/3.teams","i-ph-users",{"title":170,"path":171,"stem":172,"icon":173},"Roles & permissions","/account-and-team/roles-and-permissions","6.account-and-team/4.roles-and-permissions","i-ph-shield",{"title":175,"path":176,"stem":177,"icon":178},"Invitations","/account-and-team/invitations","6.account-and-team/5.invitations","i-ph-envelope-simple",{"title":180,"path":181,"stem":182,"icon":21},"Billing & upgrades","/account-and-team/billing","6.account-and-team/6.billing",{"title":184,"path":185,"stem":186,"icon":187},"Support","/account-and-team/support","6.account-and-team/7.support","i-ph-lifebuoy","i-ph-user",{"title":190,"path":191,"stem":192,"children":193,"icon":195},"Apps","/apps","7.apps/1.index",[194,196],{"title":190,"path":191,"stem":192,"icon":195},"i-ph-squares-four",{"title":197,"path":198,"stem":199,"icon":119},"Building an app","/apps/building-an-app","7.apps/2.building-an-app",{"id":201,"title":148,"body":202,"description":437,"extension":438,"links":439,"meta":440,"navigation":441,"path":149,"seo":442,"stem":150,"__hash__":443},"docs/5.connect-your-tools/6.secrets.md",{"type":203,"value":204,"toc":427},"minimark",[205,209,217,224,229,232,282,303,307,345,352,356,364,370,373,391,395,421],[206,207,148],"h1",{"id":208},"secrets",[210,211,212,213,216],"p",{},"The ",[214,215,208],"strong",{}," vault stores credentials your agents need — API keys, logins, and OAuth grants\n— encrypted and scoped to your workspace. You store a value once, assign it to the agents that\nneed it, and they use it without ever seeing the raw secret. Plaintext is never shown back\nafter you save it.",[210,218,219,220,223],{},"Open ",[214,221,222],{},"Settings ▸ Secrets"," from the left rail.",[225,226,228],"h2",{"id":227},"secret-types","Secret types",[210,230,231],{},"When you add a secret you pick one of three types:",[233,234,235,248],"table",{},[236,237,238],"thead",{},[239,240,241,245],"tr",{},[242,243,244],"th",{},"Type",[242,246,247],{},"Use it for",[249,250,251,262,272],"tbody",{},[239,252,253,259],{},[254,255,256],"td",{},[214,257,258],{},"API key",[254,260,261],{},"A single key or token for a service.",[239,263,264,269],{},[254,265,266],{},[214,267,268],{},"Password",[254,270,271],{},"A username and password pair.",[239,273,274,279],{},[254,275,276],{},[214,277,278],{},"Generic",[254,280,281],{},"Any other single value.",[210,283,284,285,289,290,293,294,293,296,298,299,302],{},"OAuth grants also appear in the vault — those come from connecting a\n",[286,287,288],"a",{"href":144},"connector"," rather than being added by hand. You can filter the\nlist by ",[214,291,292],{},"All",", ",[214,295,258],{},[214,297,268],{},", or ",[214,300,301],{},"OAuth",".",[225,304,306],{"id":305},"add-a-secret","Add a secret",[308,309,310,319,325,332,339],"ol",{},[311,312,219,313,315,316,302],"li",{},[214,314,148],{}," and select ",[214,317,318],{},"Add secret",[311,320,321,322,302],{},"Choose the ",[214,323,324],{},"type",[311,326,327,328,331],{},"Enter a ",[214,329,330],{},"name"," and the value(s).",[311,333,334,335,338],{},"Optionally turn on ",[214,336,337],{},"Extended audit retention"," (see below).",[311,340,341,342,302],{},"Select ",[214,343,344],{},"Create secret",[210,346,347],{},[348,349],"img",{"alt":350,"src":351},"the Add a secret modal showing the type selector and value fields","/screenshots/secrets-add.png",[225,353,355],{"id":354},"assign-to-agents","Assign to agents",[210,357,358,359,363],{},"A secret is only usable by the agents you grant it to. Each row shows the agents that currently\nhave access; open the agent popover to grant or revoke access per agent. Open a secret to see\nits detail slideover, where each secret exposes a reference like ",[360,361,362],"code",{},"secrets.MY_KEY"," that agents\nuse to read the value, along with its masked preview, when it was last used, total access count,\nand the agents with access.",[210,365,366],{},[348,367],{"alt":368,"src":369},"the secret detail slideover with the masked value, usage stats, and agent access list","/screenshots/secret-detail.png",[225,371,337],{"id":372},"extended-audit-retention",[210,374,375,376,378,379,382,383,386,387,390],{},"Turn on ",[214,377,337],{}," when adding a secret to keep its access log for ",[214,380,381],{},"1 year","\ninstead of the default ",[214,384,385],{},"90 days"," — useful for especially sensitive credentials. This option\nis available on the ",[214,388,389],{},"Pro"," plan.",[225,392,394],{"id":393},"security","Security",[396,397,398,405,412,415],"ul",{},[311,399,400,401,404],{},"Secrets are ",[214,402,403],{},"encrypted"," and scoped to the workspace.",[311,406,407,408,411],{},"Values are ",[214,409,410],{},"masked"," in the UI — plaintext does not round-trip back to your browser after\nsaving.",[311,413,414],{},"Agents read a secret by reference and never see the raw value.",[311,416,417,418,302],{},"Every read, grant, and revoke is recorded in the ",[286,419,420],{"href":153},"audit log",[422,423,424],"warning",{},[210,425,426],{},"Deleting a secret removes it and its access log permanently, and agents that rely on it stop\nworking immediately. If a secret is exposed, rotate it at the provider and update the value here.",{"title":428,"searchDepth":429,"depth":430,"links":431},"",1,2,[432,433,434,435,436],{"id":227,"depth":430,"text":228},{"id":305,"depth":430,"text":306},{"id":354,"depth":430,"text":355},{"id":372,"depth":430,"text":337},{"id":393,"depth":430,"text":394},"Store API keys and credentials in an encrypted, workspace-scoped vault.","md",null,{},{"icon":100},{"title":148,"description":437},"PSiE5GRzFbKZCEyXgYyWXMdhX7yrBaFkF0uUg7Y-0hU",[445,447],{"title":143,"path":144,"stem":145,"description":446,"icon":146,"children":-1},"Connect external tools — Gmail, Zendesk, PostHog, and more — to your agents.",{"title":152,"path":153,"stem":154,"description":448,"icon":155,"children":-1},"See when and how your secrets were accessed.",1787397457983]