Create a project, mint a key, add two lines to .env — and your next run appears.
A project groups the eval suites of one codebase. An API key belongs to exactly one
project, and runs reported with it are filed there.
1. Create the project
From the sidebar’s +, or Projects → New project. Name it after the application, not
the agent — one Laravel app with six agents is one project.
2. Create a key
New projects show their connection steps immediately, including a key created for you:
The full key is shown once, when it is created. Only a sha256 hash is stored, so we
genuinely cannot show it to you again — not “won’t”. If you lose it, create another.
3. Add it to your environment
.env
VIZRA_CLOUD_KEY=vz_your_key_here
That is the whole configuration on the hosted service. VIZRA_CLOUD_ENDPOINT defaults to
https://vizra.ai/api/v1/runs and only needs setting if you are pointing at a
self-hosted instance.
The run finishes, reports, and appears in the project. Nothing else changes — the same run
is still recorded locally, and the gate still decides pass or fail exactly as before. See
what gets reported.
Managing keys
Each key shows its project, when it was created, whether it has ever been used, and its
expiry. “Never used” is usually the answer to “why aren’t my runs showing up”.
Expiry
Choose Never, 30 days, 90 days or a year when creating a key. An expired key
stops being accepted at ingest; runs still record locally.
Rotate, don’t revoke
Rotate creates a replacement and keeps the old key working for 7 days, so you can
deploy the new one everywhere before the old one stops. Rotation never extends an expiry
that was already sooner than the grace period.Revoke stops the key immediately. Worth knowing what that looks like from the other
side: a rejected upload never fails a build, so anything still using the key goes quiet
rather than erroring — you notice by the missing runs, not by a red pipeline.
Give CI its own key, named for the pipeline. When you rotate it you know exactly what has
to be redeployed, and revoking it doesn’t stop anyone’s laptop reporting.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vizra","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/vizra-0d76d98a/FrJ0V5Ffl9izWiTJ/images/logo.svg?fit=max\u0026auto=format\u0026n=FrJ0V5Ffl9izWiTJ\u0026q=85\u0026s=6f423f5ffda16c2e2e953e21d1150214","dark":"https://mintcdn.com/vizra-0d76d98a/FrJ0V5Ffl9izWiTJ/images/logo.svg?fit=max\u0026auto=format\u0026n=FrJ0V5Ffl9izWiTJ\u0026q=85\u0026s=6f423f5ffda16c2e2e953e21d1150214","href":"https://vizra.ai"},"favicon":"https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/favicon.svg?fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=86af5ed7c4aea236f0a325bc49f4543f","navbar":{"links":[{"href":"https://github.com/vizra-ai/vizra-evals","label":"GitHub"},{"href":"https://discord.gg/CRRzmvS5MK","label":"Discord"}],"primary":{"type":"button","label":"Get Started","href":"/evals/quickstart"}},"footer":{"socials":{"github":"https://github.com/vizra-ai","discord":"https://discord.gg/CRRzmvS5MK","x":"https://x.com/aaronlumsden"}},"integrations":{"ga4":{"measurementId":"G-8X888FYD3F"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"vizra-0d76d98a","hasAudioNarration":false,"actualSubdomain":"vizra-0d76d98a","customDomains":["docs.vizra.ai"],"gitSource":{"type":"github","owner":"vizra-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae946fa7a557f4aa931affc:success","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"ADK","count":37},{"language":"default","tag":"Evals","count":20},{"language":"default","tag":"Getting Started","count":9},{"language":"default","tag":"API Reference","count":8},{"language":"default","tag":"Writing Evals","count":8},{"language":"default","tag":"Core Concepts","count":7},{"language":"default","tag":"Cloud","count":6},{"language":"default","tag":"Advanced Features","count":5},{"language":"default","tag":"Integrations","count":4},{"language":"default","tag":"Agents","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"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","content":".nav-logo{width:100px;height:36px;transform:translateX(-30px);margin-left:24px}"}],"page":{"pagePath":"cloud/connect","slug":"/cloud/connect","pageMetadata":{"title":"Connect a Project","description":"Create a project, mint a key, add two lines to .env — and your next run appears.","icon":"plug","href":"/cloud/connect"},"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: \"Create a project, mint a key, add two lines to .env — and your next run appears.\"\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`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`project`}),` groups the eval suites of one codebase. An `,_jsx(_components.strong,{children:`API key`}),` belongs to exactly one\nproject, and runs reported with it are filed there.`]}),`\n`,_jsx(Heading,{level:`2`,id:`1-create-the-project`,children:`1. Create the project`}),`\n`,_jsxs(_components.p,{children:[`From the sidebar’s `,_jsx(_components.code,{children:`+`}),`, or `,_jsx(_components.strong,{children:`Projects → New project`}),`. Name it after the application, not\nthe agent — one Laravel app with six agents is one project.`]}),`\n`,_jsx(Heading,{level:`2`,id:`2-create-a-key`,children:`2. Create a key`}),`\n`,_jsx(_components.p,{children:`New projects show their connection steps immediately, including a key created for you:`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=0c02eb8fdfcfddb4d9624f77648cef37`,alt:`A new project's connect panel: composer require, the two env lines, and the run command`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`723`,height:`723`,\"data-path\":`images/screenshots/cloud-connect.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=f0d42c8e73d72d6f211b326217702e78 280w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=f1628d9181773c9ea00b98a0effc2712 560w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=3fafd2ef41b4de99581aea479389f081 840w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=d8cbaca007efde5fdb8e085d6cea3acf 1100w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=b8d910935dfa389028bc1bef1001d423 1650w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-connect.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=c8512b29009d6e683d4fbbd416f5d3c6 2500w`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The full key is shown `,_jsx(_components.strong,{children:`once`}),`, when it is created. Only a sha256 hash is stored, so we\ngenuinely cannot show it to you again — not “won’t”. If you lose it, create another.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`3-add-it-to-your-environment`,children:`3. Add it to your environment`}),`\n`,_jsx(CodeBlock,{filename:`.env`,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`VIZRA_CLOUD_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`vz_your_key_here`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`That is the whole configuration on the hosted service. `,_jsx(_components.code,{children:`VIZRA_CLOUD_ENDPOINT`}),` defaults to\n`,_jsx(_components.code,{children:`https://vizra.ai/api/v1/runs`}),` and only needs setting if you are pointing at a\nself-hosted instance.`]}),`\n`,_jsx(Heading,{level:`2`,id:`4-run-your-evals`,children:`4. Run your evals`}),`\n`,_jsx(CodeBlock,{filename:`Terminal`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`./vendor/bin/pest`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --evals`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# or`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`php`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` artisan`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` evals:run`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The run finishes, reports, and appears in the project. Nothing else changes — the same run\nis still recorded locally, and the gate still decides pass or fail exactly as before. See\n`,_jsx(_components.a,{href:`/cloud/reporting`,children:`what gets reported`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`managing-keys`,children:`Managing keys`}),`\n`,_jsx(Frame,{children:_jsx(OptimizedImage,{src:`https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=5258c4a0ebdae48dca2d6ddaed9516fb`,alt:`The API keys tab, showing masked keys with their project, last use, expiry and rotate/revoke actions`,\"data-og-width\":`1440`,width:`1440`,\"data-og-height\":`723`,height:`723`,\"data-path\":`images/screenshots/cloud-keys.jpg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=280\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=30640c431feae4a4c29062de7b9f19ad 280w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=560\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=1b7ab10d662dd422058aed637374ae96 560w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=840\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=18df8f9c8ba8aef31928e673990d3f74 840w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=1100\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=358d1dc6fe694c199a65c99017328375 1100w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=1650\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=6e37e29fb61ba115e22f2d9305dc303d 1650w, https://mintcdn.com/vizra-0d76d98a/9Ppsvu5jaMTS7XpB/images/screenshots/cloud-keys.jpg?w=2500\u0026fit=max\u0026auto=format\u0026n=9Ppsvu5jaMTS7XpB\u0026q=85\u0026s=19237a2d4bed6f2ca7cf3a4bf8e6b254 2500w`})}),`\n`,_jsxs(_components.p,{children:[`Each key shows its project, when it was created, whether it has `,_jsx(_components.strong,{children:`ever been used`}),`, and its\nexpiry. “Never used” is usually the answer to “why aren’t my runs showing up”.`]}),`\n`,_jsx(Heading,{level:`3`,id:`expiry`,children:`Expiry`}),`\n`,_jsxs(_components.p,{children:[`Choose `,_jsx(_components.strong,{children:`Never`}),`, `,_jsx(_components.strong,{children:`30 days`}),`, `,_jsx(_components.strong,{children:`90 days`}),` or `,_jsx(_components.strong,{children:`a year`}),` when creating a key. An expired key\nstops being accepted at ingest; runs still record locally.`]}),`\n`,_jsx(Heading,{level:`3`,id:`rotate-don’t-revoke`,children:`Rotate, don’t revoke`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Rotate`}),` creates a replacement and keeps the old key working for `,_jsx(_components.strong,{children:`7 days`}),`, so you can\ndeploy the new one everywhere before the old one stops. Rotation never `,_jsx(_components.em,{children:`extends`}),` an expiry\nthat was already sooner than the grace period.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Revoke`}),` stops the key immediately. Worth knowing what that looks like from the other\nside: a rejected upload never fails a build, so anything still using the key goes quiet\nrather than erroring — you notice by the missing runs, not by a red pipeline.`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Give CI its own key, named for the pipeline. When you rotate it you know exactly what has\nto be redeployed, and revoking it doesn’t stop anyone’s laptop reporting.`})})]})}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":"Connect a Project","description":"Create a project, mint a key, add two lines to .env — and your next run appears.","icon":"plug","href":"/cloud/connect"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"1. Create the project","slug":"1-create-the-project","depth":2,"children":[]},{"title":"2. Create a key","slug":"2-create-a-key","depth":2,"children":[]},{"title":"3. Add it to your environment","slug":"3-add-it-to-your-environment","depth":2,"children":[]},{"title":"4. Run your evals","slug":"4-run-your-evals","depth":2,"children":[]},{"title":"Managing keys","slug":"managing-keys","depth":2,"children":[{"title":"Expiry","slug":"expiry","depth":3,"children":[]},{"title":"Rotate, don’t revoke","slug":"rotate-don’t-revoke","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"vizra-0d76d98a","siteName":"Vizra","title":"Connect a Project - Vizra","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-20T09:24:08.168Z","originalFileLocation":"cloud/connect.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=\"Create a project, mint a key, add two lines to .env — and your next run appears.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vizra\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect a Project - Vizra\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a project, mint a key, add two lines to .env — and your next run appears.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vizra\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vizra.ai/cloud/connect\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://vizra-0d76d98a.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Connect+a+Project\u0026amp;description=Create+a+project%2C+mint+a+key%2C+add+two+lines+to+.env+%E2%80%94+and+your+next+run+appears.\u0026amp;theme=4486a0688d9936fd0a264a81\u0026amp;signature=b309e93c77e4ad724702680dfef9a1605bf7946704bf7ba4f60287202ac49b5f\">\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=\"Connect a Project - Vizra\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a project, mint a key, add two lines to .env — and your next run appears.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://vizra-0d76d98a.mintlify.site/_mintlify/api/og/v2?division=Getting+Started\u0026amp;title=Connect+a+Project\u0026amp;description=Create+a+project%2C+mint+a+key%2C+add+two+lines+to+.env+%E2%80%94+and+your+next+run+appears.\u0026amp;theme=4486a0688d9936fd0a264a81\u0026amp;signature=b309e93c77e4ad724702680dfef9a1605bf7946704bf7ba4f60287202ac49b5f\">\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/vizra-0d76d98a/UJRSgCaxWlyT_oG9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vizra\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vizra.ai/cloud/connect\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/cloud/connect.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vizra.ai/#organization\",\"name\":\"Vizra\",\"url\":\"https://docs.vizra.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/vizra-0d76d98a/FrJ0V5Ffl9izWiTJ/images/logo.svg?fit=max\u0026auto=format\u0026n=FrJ0V5Ffl9izWiTJ\u0026q=85\u0026s=6f423f5ffda16c2e2e953e21d1150214\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vizra.ai#website\",\"name\":\"Vizra\",\"url\":\"https://docs.vizra.ai\",\"publisher\":{\"@id\":\"https://docs.vizra.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vizra.ai/cloud/connect#webpage\",\"url\":\"https://docs.vizra.ai/cloud/connect\",\"name\":\"Connect a Project\",\"description\":\"Create a project, mint a key, add two lines to .env — and your next run appears.\",\"dateModified\":\"2026-08-20T09:24:08.168Z\",\"isPartOf\":{\"@id\":\"https://docs.vizra.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vizra.ai/cloud/connect#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vizra.ai/cloud/connect#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting Started\",\"item\":\"https://docs.vizra.ai/cloud\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect a Project\",\"item\":\"https://docs.vizra.ai/cloud/connect\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.vizra.ai/cloud/connect#article\",\"headline\":\"Connect a Project\",\"name\":\"Connect a Project\",\"description\":\"Create a project, mint a key, add two lines to .env — and your next run appears.\",\"url\":\"https://docs.vizra.ai/cloud/connect\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vizra.ai/cloud/connect#webpage\"},\"dateModified\":\"2026-08-20T09:24:08.168Z\",\"publisher\":{\"@id\":\"https://docs.vizra.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vizra.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vizra\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Vizra\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/cloud/connect.md","siteName":"Vizra","nav":{"global":null,"tabs":[{"tab":"Evals","pages":[{"title":"Evals","href":""}]},{"tab":"Cloud","groups":[{"group":"Getting Started","pages":[{"title":"Vizra Cloud","description":"Your team's eval history in one place — laptop runs, CI runs, and the ability to run a suite from the browser.","icon":"cloud","href":"/cloud"},{"title":"Connect a Project","icon":"plug","href":"/cloud/connect"}]},{"group":"Using Cloud","pages":[{"title":"Reporting Runs","description":"Which surfaces push to Cloud, what's in the payload, and why a flaky uplink can never fail your build.","icon":"upload","href":"/cloud/reporting"},{"title":"Running from the Dashboard","icon":"play","href":"/cloud/triggering"},{"title":"Editing Datasets","icon":"table","href":"/cloud/datasets"}]},{"group":"Account","pages":[{"title":"Plans \u0026 Retention","icon":"receipt","href":"/cloud/plans"}]}]},{"tab":"ADK","pages":[{"title":"ADK","href":"/adk"}]}]},"basePath":"","title":"Connect a Project - Vizra","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DevImLcx.js","DynamicMarkdown-BGHukeRM.js","zoom-image-lightbox-DQG3o8Eu.js","lightbox-handle-r17bVUz3.js"]}