[{"data":1,"prerenderedAt":405},["ShallowReactive",2],{"doc-\u002Fdocs\u002Freference\u002Fsettings-and-api-keys":3,"docs-nav":282},{"id":4,"title":5,"body":6,"description":274,"extension":275,"meta":276,"navigation":277,"path":278,"seo":279,"stem":280,"__hash__":281},"content\u002Fdocs\u002F5.reference\u002F1.settings-and-api-keys.md","Settings & API Keys",{"type":7,"value":8,"toc":257},"minimark",[9,13,22,27,30,62,66,75,80,87,107,111,125,129,149,153,174,178,185,188,199,203,211,226,230,233,237],[10,11,5],"h1",{"id":12},"settings-api-keys",[14,15,16,17,21],"p",{},"Account-level settings live in the ",[18,19,20],"strong",{},"Settings"," view, accessed from the left sidebar of the app. There are four areas: account, API keys, integrations, and credits.",[23,24,26],"h2",{"id":25},"account","Account",[14,28,29],{},"Basic profile management:",[31,32,33,40,46,56],"ul",{},[34,35,36,39],"li",{},[18,37,38],{},"Name"," — first and last name, used in the welcome flow and in shared exports.",[34,41,42,45],{},[18,43,44],{},"Email"," — your sign-in identifier. Changes here require confirmation.",[34,47,48,51,52,55],{},[18,49,50],{},"Password"," — change your password. If you've forgotten it, use ",[18,53,54],{},"Forgot password"," from the sign-in screen instead.",[34,57,58,61],{},[18,59,60],{},"Theme"," — light or dark. The choice is stored locally per browser; toggling it from the navbar does the same thing.",[23,63,65],{"id":64},"api-keys","API keys",[14,67,68,69,74],{},"API keys authenticate external tools (most importantly the ",[70,71,73],"a",{"href":72},"..\u002Fgetting-started\u002Fzotero-integration","Zotero plugin",") against your account.",[76,77,79],"h3",{"id":78},"creating-a-key","Creating a key",[14,81,82,83,86],{},"In ",[18,84,85],{},"Settings → API Keys",":",[88,89,90,97,100],"ol",{},[34,91,92,93,96],{},"Click ",[18,94,95],{},"Create API key",".",[34,98,99],{},"Give it a descriptive name (e.g., \"Zotero on my laptop\", \"Zotero on the lab desktop\"). The name is for your reference — pick something that helps you identify the key in the list later.",[34,101,102,103,106],{},"Click create. The key is shown ",[18,104,105],{},"once"," in a modal. Copy it immediately and paste it where you need it; you can't view the full key again afterward.",[76,108,110],{"id":109},"what-you-can-do-with-an-existing-key","What you can do with an existing key",[31,112,113,119],{},[34,114,115,118],{},[18,116,117],{},"Rename"," — for clarity, doesn't affect the key itself.",[34,120,121,124],{},[18,122,123],{},"Revoke"," — immediately invalidates the key. Any tool using it will start getting authentication errors. Use this if a key is lost, leaked, or no longer needed.",[76,126,128],{"id":127},"best-practices","Best practices",[31,130,131,137,143],{},[34,132,133,136],{},[18,134,135],{},"One key per device or tool."," Don't share a single key across multiple installations of the Zotero plugin — revoking it kills all of them at once. Issue separate keys per machine and you can revoke surgically.",[34,138,139,142],{},[18,140,141],{},"Rotate occasionally."," No automatic rotation today; rotation is your call. Quarterly is a reasonable cadence for keys used in long-running setups.",[34,144,145,148],{},[18,146,147],{},"Don't paste keys into shared documents."," Treat them as you'd treat a password.",[76,150,152],{"id":151},"how-the-key-is-used","How the key is used",[14,154,155,156,160,161,165,166,169,170,173],{},"All requests authenticated via the ",[157,158,159],"code",{},"X-API-Key"," HTTP header. The Zotero plugin sends the key with every request to the backend. Errors distinguish between ",[162,163,164],"em",{},"missing",", ",[162,167,168],{},"invalid",", and ",[162,171,172],{},"network failure"," so you can diagnose without guessing.",[23,175,177],{"id":176},"integrations","Integrations",[14,179,180,181,184],{},"Connections to external tools you've authorized. Currently this is where Zotero shows up once you've installed the plugin and successfully run ",[18,182,183],{},"Test Connection"," from its preferences pane.",[14,186,187],{},"Each integration listing shows:",[31,189,190,193,196],{},[34,191,192],{},"The tool's name and current status.",[34,194,195],{},"When it last successfully called the API.",[34,197,198],{},"A link to revoke the integration (which revokes the corresponding API key).",[23,200,202],{"id":201},"credits","Credits",[14,204,205,206,210],{},"Covered in detail in ",[70,207,209],{"href":208},"..\u002Fgetting-started\u002Fcredits-and-billing","Credits & Billing",". The settings page shows:",[31,212,213,216,219],{},[34,214,215],{},"Current balance (recurring + add-on).",[34,217,218],{},"Full usage history with operation type and timestamp.",[34,220,221,222,225],{},"A ",[18,223,224],{},"How credits work"," explainer.",[23,227,229],{"id":228},"signing-out","Signing out",[14,231,232],{},"Sign-out is in the navbar \u002F user menu. Sessions are per-browser; signing out doesn't affect other devices or the Zotero plugin (which uses an API key, not your session).",[23,234,236],{"id":235},"whats-next","What's next",[31,238,239,245,250],{},[34,240,241,244],{},[70,242,243],{"href":72},"Zotero Integration"," — installing and connecting the plugin.",[34,246,247,249],{},[70,248,209],{"href":208}," — usage and balance.",[34,251,252,256],{},[70,253,255],{"href":254},".\u002Ftroubleshooting-and-faq","Troubleshooting & FAQ"," — common issues and fixes.",{"title":258,"searchDepth":259,"depth":259,"links":260},"",4,[261,263,270,271,272,273],{"id":25,"depth":262,"text":26},2,{"id":64,"depth":262,"text":65,"children":264},[265,267,268,269],{"id":78,"depth":266,"text":79},3,{"id":109,"depth":266,"text":110},{"id":127,"depth":266,"text":128},{"id":151,"depth":266,"text":152},{"id":176,"depth":262,"text":177},{"id":201,"depth":262,"text":202},{"id":228,"depth":262,"text":229},{"id":235,"depth":262,"text":236},"Account-level settings live in the Settings view, accessed from the left sidebar of the app. There are four areas: account, API keys, integrations, and credits.","md",{},true,"\u002Fdocs\u002Freference\u002Fsettings-and-api-keys",{"title":5,"description":274},"docs\u002F5.reference\u002F1.settings-and-api-keys","DHWHVdsB-t9_HVwb8_3LcpP9PRV8GfHHbUj-5kPrHEg",[283,305,341,373,397],{"slug":284,"title":285,"items":286},"getting-started","Getting Started",[287,291,295,299,302],{"path":288,"title":289,"stem":290},"\u002Fdocs\u002Fgetting-started\u002Fintroduction","Introduction","docs\u002F1.getting-started\u002F1.introduction",{"path":292,"title":293,"stem":294},"\u002Fdocs\u002Fgetting-started\u002Fquickstart","Quickstart","docs\u002F1.getting-started\u002F2.quickstart",{"path":296,"title":297,"stem":298},"\u002Fdocs\u002Fgetting-started\u002Fthe-interface","The Interface","docs\u002F1.getting-started\u002F3.the-interface",{"path":300,"title":243,"stem":301},"\u002Fdocs\u002Fgetting-started\u002Fzotero-integration","docs\u002F1.getting-started\u002F4.zotero-integration",{"path":303,"title":209,"stem":304},"\u002Fdocs\u002Fgetting-started\u002Fcredits-and-billing","docs\u002F1.getting-started\u002F5.credits-and-billing",{"slug":306,"title":307,"items":308},"core-concepts","Core Concepts",[309,313,317,321,325,329,333,337],{"path":310,"title":311,"stem":312},"\u002Fdocs\u002Fcore-concepts\u002Fprojects","Projects","docs\u002F2.core-concepts\u002F1.projects",{"path":314,"title":315,"stem":316},"\u002Fdocs\u002Fcore-concepts\u002Fknowledge-bases","Knowledge Bases","docs\u002F2.core-concepts\u002F2.knowledge-bases",{"path":318,"title":319,"stem":320},"\u002Fdocs\u002Fcore-concepts\u002Frag-and-retrieval","RAG and Retrieval","docs\u002F2.core-concepts\u002F3.rag-and-retrieval",{"path":322,"title":323,"stem":324},"\u002Fdocs\u002Fcore-concepts\u002Flabeled-items","Labeled Items","docs\u002F2.core-concepts\u002F4.labeled-items",{"path":326,"title":327,"stem":328},"\u002Fdocs\u002Fcore-concepts\u002Fmindmaps-nodes-and-claims","Mindmaps, Nodes & Claims","docs\u002F2.core-concepts\u002F5.mindmaps-nodes-and-claims",{"path":330,"title":331,"stem":332},"\u002Fdocs\u002Fcore-concepts\u002Fthe-multi-agent-system","The Multi-Agent System","docs\u002F2.core-concepts\u002F6.the-multi-agent-system",{"path":334,"title":335,"stem":336},"\u002Fdocs\u002Fcore-concepts\u002Fterminology-graph-explorer","Terminology Graph Explorer","docs\u002F2.core-concepts\u002F7.terminology-graph-explorer",{"path":338,"title":339,"stem":340},"\u002Fdocs\u002Fcore-concepts\u002Fai-verification","AI Verification","docs\u002F2.core-concepts\u002F8.ai-verification",{"slug":342,"title":343,"items":344},"research-workflows","Research Workflows",[345,349,353,357,361,365,369],{"path":346,"title":347,"stem":348},"\u002Fdocs\u002Fresearch-workflows\u002Fliterature-review","Literature Review","docs\u002F3.research-workflows\u002F1.literature-review",{"path":350,"title":351,"stem":352},"\u002Fdocs\u002Fresearch-workflows\u002Fhypothesis-generation-and-testing","Hypothesis Generation & Testing","docs\u002F3.research-workflows\u002F2.hypothesis-generation-and-testing",{"path":354,"title":355,"stem":356},"\u002Fdocs\u002Fresearch-workflows\u002Fthematic-analysis","Thematic Analysis","docs\u002F3.research-workflows\u002F3.thematic-analysis",{"path":358,"title":359,"stem":360},"\u002Fdocs\u002Fresearch-workflows\u002Fcomparative-analysis","Comparative Analysis","docs\u002F3.research-workflows\u002F4.comparative-analysis",{"path":362,"title":363,"stem":364},"\u002Fdocs\u002Fresearch-workflows\u002Fnode-transformation","Node Transformation","docs\u002F3.research-workflows\u002F5.node-transformation",{"path":366,"title":367,"stem":368},"\u002Fdocs\u002Fresearch-workflows\u002Foutlining-a-paper","Outlining a Paper","docs\u002F3.research-workflows\u002F6.outlining-a-paper",{"path":370,"title":371,"stem":372},"\u002Fdocs\u002Fresearch-workflows\u002Fgap-finding","Gap Finding","docs\u002F3.research-workflows\u002F7.gap-finding",{"slug":374,"title":375,"items":376},"working-with-the-agent","Working With The Agent",[377,381,385,389,393],{"path":378,"title":379,"stem":380},"\u002Fdocs\u002Fworking-with-the-agent\u002Fwriting-instructions","Writing Instructions","docs\u002F4.working-with-the-agent\u002F1.writing-instructions",{"path":382,"title":383,"stem":384},"\u002Fdocs\u002Fworking-with-the-agent\u002Fagent-context","Agent Context","docs\u002F4.working-with-the-agent\u002F2.agent-context",{"path":386,"title":387,"stem":388},"\u002Fdocs\u002Fworking-with-the-agent\u002Fconversational-refinement","Conversational Refinement","docs\u002F4.working-with-the-agent\u002F3.conversational-refinement",{"path":390,"title":391,"stem":392},"\u002Fdocs\u002Fworking-with-the-agent\u002Fconfidence-gaps-and-iteration-limits","Confidence, Gaps & Iteration Limits","docs\u002F4.working-with-the-agent\u002F4.confidence-gaps-and-iteration-limits",{"path":394,"title":395,"stem":396},"\u002Fdocs\u002Fworking-with-the-agent\u002Fversion-history-and-provenance","Version History & Provenance","docs\u002F4.working-with-the-agent\u002F5.version-history-and-provenance",{"slug":398,"title":399,"items":400},"reference","Reference",[401,402],{"path":278,"title":5,"stem":280},{"path":403,"title":255,"stem":404},"\u002Fdocs\u002Freference\u002Ftroubleshooting-and-faq","docs\u002F5.reference\u002F2.troubleshooting-and-faq",1780503376376]