testworld gives an agent a workplace to act in: Gmail, Slack and Calendar seeded with realistic data. Nothing the agent does reaches a real system. Every tool call is recorded, and when the run ends you get the trace and an evaluation of the end state.The hosted API opens with early access. The address and the key come with the invitation. In these docs $TESTWORLD_URL is the address and $TESTWORLD_KEY is the key.
Quickstart
Four calls from nothing to a scored run.
API reference
The six routes, with a playground.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"testworld","colors":{"primary":"#6B625A","light":"#A39A92","dark":"#2B2622"},"favicon":"https://mintcdn.com/testworld/CNxEOTTe8Co_oqta/favicon.png?fit=max\u0026auto=format\u0026n=CNxEOTTe8Co_oqta\u0026q=85\u0026s=cfd7798f11dc618bc137b0d1a15c2feb","navbar":{"primary":{"type":"button","label":"Get early access","href":"https://testworld.dev/#access"}},"footer":{"links":[{"header":"testworld","items":[{"label":"Website","href":"https://testworld.dev"}]}]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"testworld","hasAudioNarration":false,"actualSubdomain":"testworld","customDomains":["docs.testworld.dev"],"gitSource":{"type":"github","owner":"dansemums","repo":"testworld","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":"","_id":"6af4e1fcdc55bf5b8cfea917"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af4e71ddc55bf5b8cff30d9","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"API reference","count":6},{"language":"default","tag":"Concepts","count":4},{"language":"default","tag":"Runs","count":4},{"language":"default","tag":"Get started","count":2},{"language":"default","tag":"Environments","count":2},{"language":"default","tag":"More","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"index","slug":"/","pageMetadata":{"title":"testworld","description":"A simulated workplace for AI agents.","href":"/index"},"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: \"A simulated workplace for AI agents.\"\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={code:`code`,p:`p`,..._provideComponents(),...props.components},{Card,Columns}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!Columns)_missingMdxReference(`Columns`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`testworld gives an agent a workplace to act in: Gmail, Slack and Calendar seeded with realistic data. Nothing the agent does reaches a real system. Every tool call is recorded, and when the run ends you get the trace and an evaluation of the end state.`}),`\n`,_jsxs(_components.p,{children:[`The hosted API opens with early access. The address and the key come with the invitation. In these docs `,_jsx(_components.code,{children:`$TESTWORLD_URL`}),` is the address and `,_jsx(_components.code,{children:`$TESTWORLD_KEY`}),` is the key.`]}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Quickstart`,icon:`rocket`,href:`/quickstart`,children:_jsx(_components.p,{children:`Four calls from nothing to a scored run.`})}),_jsx(Card,{title:`API reference`,icon:`code`,href:`/api-reference/environments/list-environments`,children:_jsx(_components.p,{children:`The six routes, with a playground.`})})]})]})}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":"testworld","description":"A simulated workplace for AI agents.","href":"/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"testworld","siteName":"testworld","title":"testworld - testworld","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T22:07:31.879Z","originalFileLocation":"index.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=\"A simulated workplace for AI agents.\">\u003cmeta data-mint-head name=\"application-name\" content=\"testworld\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_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/testworld/vslUQfpK_qeyI4eL/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"testworld - testworld\">\u003cmeta data-mint-head property=\"og:description\" content=\"A simulated workplace for AI agents.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"testworld\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.testworld.dev\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://testworld.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=testworld\u0026amp;description=A+simulated+workplace+for+AI+agents.\u0026amp;theme=03e32b58549ae12ce03b1eb1\u0026amp;signature=7d59d99ab09a65726505bf553db98f1967c3b14ec44501165ade78cce6797f9a\">\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=\"testworld - testworld\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"A simulated workplace for AI agents.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://testworld.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=testworld\u0026amp;description=A+simulated+workplace+for+AI+agents.\u0026amp;theme=03e32b58549ae12ce03b1eb1\u0026amp;signature=7d59d99ab09a65726505bf553db98f1967c3b14ec44501165ade78cce6797f9a\">\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/testworld/vslUQfpK_qeyI4eL/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"testworld\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6B625A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.testworld.dev\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/index.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.testworld.dev/#organization\",\"name\":\"testworld\",\"url\":\"https://docs.testworld.dev\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.testworld.dev#website\",\"name\":\"testworld\",\"url\":\"https://docs.testworld.dev\",\"publisher\":{\"@id\":\"https://docs.testworld.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.testworld.dev/#webpage\",\"url\":\"https://docs.testworld.dev/\",\"name\":\"testworld\",\"description\":\"A simulated workplace for AI agents.\",\"dateModified\":\"2026-11-11T22:07:31.879Z\",\"isPartOf\":{\"@id\":\"https://docs.testworld.dev#website\"}},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.testworld.dev/#article\",\"headline\":\"testworld\",\"name\":\"testworld\",\"description\":\"A simulated workplace for AI agents.\",\"url\":\"https://docs.testworld.dev/\",\"mainEntityOfPage\":{\"@id\":\"https://docs.testworld.dev/#webpage\"},\"dateModified\":\"2026-11-11T22:07:31.879Z\",\"publisher\":{\"@id\":\"https://docs.testworld.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.testworld.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"testworld\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"testworld\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/index.md","siteName":"testworld","nav":{"global":null,"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"testworld","href":""},{"title":"Quickstart","description":"Create a run, point your agent at it, finish it, read the result.","href":"/quickstart"}]},{"group":"Concepts","pages":[{"title":"Environments, runs and results","href":"/runs"},{"title":"Checks","href":"/checks"},{"title":"Tools","href":"/tools"},{"title":"Errors","href":"/errors"}]},{"group":"More","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/environments/list-environments"}]}]},"basePath":"","title":"testworld - testworld","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}