Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.
A computer-use agent sees a screen and decides what to click, type, and scroll. Use one when the work lives behind a user interface with no API. The Agents API runs these agents for you: describe the task, and H provisions a browser or desktop, runs a Holo-powered agent on it, and streams progress and the result back through a session you can watch, steer, and stop.Everything works from the SDKs, CLI, and REST API, and from the platform with no code.
from hai_agents import Clientclient = Client()result = client.run_session( agent="h/web-surfer-flash", messages="Open Hacker News and list the top 3 stories with their URLs.",)print(result.answer)
Get a key and run this in any language: Quickstart.
The agent finds a vinyl on Amazon and adds it to the cart.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"H Platform Docs","description":"Documentation for H's computer-use platform: the Agents API, the Holo Models API, HoloDesktop CLI, and the HoloTab Chrome extension.","colors":{"primary":"#1d1d1f","light":"#ececee","dark":"#1d1d1f"},"logo":{"light":"https://mintcdn.com/hcompany/vPduESIuGEAUuxP5/images/logo-light.svg?fit=max\u0026auto=format\u0026n=vPduESIuGEAUuxP5\u0026q=85\u0026s=a39948dec920a4705f038b3ded597245","dark":"https://mintcdn.com/hcompany/vPduESIuGEAUuxP5/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=vPduESIuGEAUuxP5\u0026q=85\u0026s=7c139b9651bbc25e1d6d55f07d729ea7"},"favicon":"https://mintcdn.com/hcompany/vPduESIuGEAUuxP5/images/favicon.svg?fit=max\u0026auto=format\u0026n=vPduESIuGEAUuxP5\u0026q=85\u0026s=9e87b8a23ed774ed37410e4fc9a8a251","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer","name":"Authorization"},"server":["https://agp.eu.hcompany.ai","https://agp.hcompany.ai"]}},"appearance":{"default":"system"},"navbar":{"links":[{"icon":"plug","href":"/docs-mcp-server","label":"Docs MCP"},{"icon":"github","href":"https://github.com/hcompai","label":"GitHub"},{"icon":"discord","href":"https://discord.gg/gAWcDZgx4s","label":"Discord"}],"primary":{"type":"button","label":"Log in","href":"https://platform.hcompany.ai/?product=computeruseagents\u0026source=docs"}},"footer":{"socials":{"github":"https://github.com/hcompai","x":"https://x.com/hcompany_ai","linkedin":"https://www.linkedin.com/company/h-company-ai","discord":"https://discord.gg/gAWcDZgx4s"},"links":[{"header":"Products","items":[{"label":"Agents API","href":"/agents-api/introduction"},{"label":"Models API","href":"/models-api/introduction"},{"label":"HoloTab","href":"/holotab/introduction"},{"label":"HoloDesktop CLI","href":"/holo-desktop-cli/introduction"}]},{"header":"Build","items":[{"label":"Quickstart","href":"/agents-api/quickstart"},{"label":"SDKs and CLI","href":"/agents-api/sdks"},{"label":"Cookbook","href":"https://github.com/hcompai/computer-use-agents-demos"},{"label":"Docs MCP","href":"/docs-mcp-server"}]},{"header":"Resources","items":[{"label":"Changelog","href":"/agents-api/changelog"},{"label":"Plans and limits","href":"/agents-api/plans-and-limits"},{"label":"H Platform","href":"https://platform.hcompany.ai"},{"label":"Hugging Face","href":"https://huggingface.co/Hcompany"}]},{"header":"Company","items":[{"label":"hcompany.ai","href":"https://hcompany.ai"},{"label":"Blog","href":"https://hcompany.ai/blog"},{"label":"Support","href":"mailto:support@hcompany.ai"},{"label":"Privacy","href":"https://hcompany.ai/privacy-policy"}]}]},"search":{"prompt":"Search the docs..."},"seo":{"metatags":{"og:type":"website","og:site_name":"H Platform Docs","twitter:card":"summary_large_image","twitter:site":"@hcompany_ai","canonical":"https://hub.hcompany.ai","og:locale":"en_US"},"organization":{"name":"H Company","url":"https://hcompany.ai","sameAs":["https://x.com/hcompany_ai","https://www.linkedin.com/company/h-company-ai","https://github.com/hcompai","https://huggingface.co/Hcompany"]},"indexing":"navigable"},"styling":{"codeblocks":"system","latex":false},"errors":{"404":{"redirect":false,"title":"Page not found","description":"This page moved or never existed. Start from the [Agents API](/agents-api/introduction) or the [Models API](/models-api/introduction), or search above."}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","add-mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/hcompany/zduyqstDKbDgiQqq/images/og-background.png?fit=max\u0026auto=format\u0026n=zduyqstDKbDgiQqq\u0026q=85\u0026s=39e33eabf5d25ac3abcfa6336cddc3db"},"markdown":{"instructions":["H Platform has four products: the Agents API (managed computer-use agents, base URL https://agp.eu.hcompany.ai/api/v2 or https://agp.hcompany.ai/api/v2 for the US), the Models API (OpenAI-compatible Holo vision-language models at https://api.hcompany.ai/v1), HoloDesktop CLI (Holo on the user's own desktop), and HoloTab (a free no-code Chrome extension that runs Holo in the user's browser, with recordable routines and schedules).","Authenticate with a bearer API key from the HAI_API_KEY environment variable. SDKs: `pip install hai-agents` (Python, `from hai_agents import Client`) and `npm install hai-agents` (TypeScript, `import { HaiAgentsClient } from \"hai-agents\"`). CLI: `hai`.","Agents do work in a browser or on a desktop; describe the task as an imperative instruction. To run a task quickly, prefer the pre-built agent `h/web-surfer-flash`. Read results from the session's `latest_answer` after it reaches a terminal status.","Sessions are the unit of work; wait for a terminal status (completed, failed, timed_out, interrupted) before reading the answer. Use webhooks or the `changes` long-poll endpoint to follow progress."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hcompany","hasAudioNarration":false,"actualSubdomain":"hcompany","customDomains":["hub.hcompany.ai"],"gitSource":{"type":"github","owner":"hcompai","repo":"platform-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb4f90b256aa4200f89037","collectionId":"7d1c8225-4c9c-4810-8d22-df8e41175319","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb4f90b256aa4200f89037"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adb4f90b256aa4200f89037","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"Agents API","count":103},{"language":"default","tag":"API reference","count":77},{"language":"default","tag":"Documentation","count":41},{"language":"default","tag":"Sessions","count":21},{"language":"default","tag":"Models API","count":15},{"language":"default","tag":"Get started","count":12},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Schedules","count":9},{"language":"default","tag":"HoloDesktop CLI","count":9},{"language":"default","tag":"Agents","count":8}]},"assistantConfig":{},"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":"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":"editor-version-history-v2","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":"billing-page-v2","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":"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":"vite-origin","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":"billing-updated-9-15","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":[{"filePath":"style.css","content":"[class*=max-w-8xl]{max-width:120rem!important}.mdx-content{max-width:none!important}#footer>[class*=max-w-],.is-center~[class*=max-w-8xl]{max-width:80rem!important}.breadcrumb-list,.eyebrow,html[data-current-path=\"/\"] #header,html[data-current-path=\"/\"] .nav-tabs-item[data-active=true]>div,html[data-current-path=\"/\"] a[aria-label=\"Navigate to header\"]{display:none}html[data-current-path=\"/\"] .nav-tabs-item[data-active=true]{color:rgb(75 85 99);text-shadow:none}html.dark[data-current-path=\"/\"] .nav-tabs-item[data-active=true]{color:rgb(156 163 175)}.not-prose a.link{border-bottom:none}.not-prose a.outlined{border:1px solid transparent}.not-prose a.card{border-color:rgb(228 228 231)}html.dark .not-prose a.card{border-color:rgb(39 39 42)}.not-prose a.outlined{transition:transform 150ms ease,border-color 150ms ease,background-color 150ms ease,box-shadow 150ms ease}.not-prose a.outlined:hover{transform:translateY(-1px);box-shadow:0 4px 12px rgb(0 0 0/.08);border-color:rgb(113 113 122);background-color:rgb(244 244 245)}html.dark .not-prose a.outlined:hover{background-color:rgb(39 39 42);box-shadow:0 4px 12px rgb(0 0 0/.4)}#footer .text-sm{font-size:.9375rem;line-height:1.5rem}.not-prose .pill{display:inline-block;border-radius:.375rem;padding:.125rem .5rem;font-size:.8125rem;font-weight:500;color:rgb(63 63 70);background:rgb(244 244 245)}html.dark .not-prose .pill{color:rgb(212 212 216);background:rgb(39 39 42)}.notice-body [data-as=p],.notice-body ol,.notice-body p,.notice-body ul{margin:0;font-size:.875rem;line-height:1.5rem}.notice-body [data-as=p]{display:block}.notice-body [data-as=p]+[data-as=p],.notice-body [data-as=p]+ol,.notice-body [data-as=p]+ul,.notice-body p+ol,.notice-body p+p,.notice-body p+ul{margin-top:.5rem}#navbar .nav-tabs{font-size:1rem}#navbar #topbar-cta-button,#navbar .navbar-link{font-size:.9375rem}.feedback-toolbar,.nav-tabs-item[href=\"/docs-mcp-server\"]{display:none}#navbar div:has(>nav.text-sm){gap:1.5rem}#navbar div:has(>nav.text-sm)>*,#navbar nav.text-sm li{margin-left:0!important}#navbar nav.text-sm,#navbar nav.text-sm>ul{display:contents}#navbar #topbar-cta-button{order:1}.not-prose a.cta-primary{border-bottom:none;transition:transform 150ms ease,box-shadow 150ms ease,opacity 150ms ease}.not-prose a.cta-primary:hover{transform:translateY(-1px);box-shadow:0 6px 16px rgb(0 0 0/.18);opacity:.92}.not-prose a.cta-primary svg{transition:transform 150ms ease}.not-prose a.cta-primary:hover svg{transform:translateX(3px)}"}],"page":{"pagePath":"agents-api/introduction","slug":"/agents-api/introduction","pageMetadata":{"title":"Agents API","sidebarTitle":"Introduction","description":"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.","keywords":["computer-use agent API","browser agent","desktop agent","web automation","Holo"],"og:description":"The Agents API runs Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults, webhooks.","href":"/agents-api/introduction"},"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: \"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.\"\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];const YouTube=({id,title})=>_jsx(`iframe`,{className:`mint-aspect-video mint-w-full mint-rounded-xl mint-border-0`,src:`https://www.youtube-nocookie.com/embed/${id}?rel=0\u0026modestbranding=1`,title,loading:`lazy`,allow:`accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share`,allowFullScreen:true});function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,Table,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`computer-use agent`}),` sees a screen and decides what to click, type, and scroll. Use one when the work lives behind a user interface with no API. The Agents API runs these agents for you: describe the task, and H provisions a browser or desktop, runs a `,_jsx(_components.a,{href:`https://hcompany.ai/newsroom/holo4`,children:`Holo`}),`-powered agent on it, and streams progress and the result back through a session you can watch, steer, and stop.`]}),`\n`,_jsxs(_components.p,{children:[`Everything works from the SDKs, CLI, and REST API, and from the `,_jsx(_components.a,{href:`/agents-api/run-from-the-platform`,children:`platform`}),` with no code.`]}),`\n`,_jsx(Heading,{level:`2`,id:`building-blocks`,children:`Building blocks`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Concept`}),_jsx(_components.th,{children:`What it is`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/agents-api/agents/overview`,children:`Agent`})}),_jsxs(_components.td,{children:[`A reusable configuration: environments, model, skills, instructions. Use a `,_jsx(_components.a,{href:`/agents-api/agents/overview#pre-built-agents`,children:`pre-built agent`}),` or create your own.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/agents-api/environments/overview`,children:`Environment`})}),_jsxs(_components.td,{children:[`What the agent sees and acts on: a cloud browser, or your own browser or desktop with `,_jsx(_components.a,{href:`/agents-api/local-control`,children:`local control`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/agents-api/sessions/overview`,children:`Session`})}),_jsx(_components.td,{children:`One run of an agent on a task, with a lifecycle you can steer.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.a,{href:`/agents-api/skills/overview`,children:`Skill`})}),_jsx(_components.td,{children:`An optional instruction fragment the agent loads when a task matches.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`run-an-agent`,children:`Run an agent`}),`\n`,_jsx(CodeBlock,{filename:`Python`,numberOfLines:`8`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`8`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` hai_agents `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Client`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Client()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.run_session(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` agent`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"h/web-surfer-flash\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` messages`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Open Hacker News and list the top 3 stories with their URLs.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(result.answer)`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Get a key and run this in any language: `,_jsx(_components.a,{href:`/agents-api/quickstart`,children:`Quickstart`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`see-it-in-action`,children:`See it in action`}),`\n`,_jsx(_components.p,{children:`The agent finds a vinyl on Amazon and adds it to the cart.`}),`\n`,_jsx(Frame,{children:_jsx(_MdxComponentBoundary,{name:`YouTube`,children:_jsx(YouTube,{id:`JFdSHV0p0dE`,title:`Computer-use Agents: Add to Cart`})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{YouTube,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":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Agents API","sidebarTitle":"Introduction","description":"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.","keywords":["computer-use agent API","browser agent","desktop agent","web automation","Holo"],"og:description":"The Agents API runs Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults, webhooks.","href":"/agents-api/introduction"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[143,481,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Building blocks","slug":"building-blocks","depth":2,"children":[]},{"title":"Run an agent","slug":"run-an-agent","depth":2,"children":[]},{"title":"See it in action","slug":"see-it-in-action","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/hcompany/b9a6b4d28fcc01b3/axeptio.js"],"dynamicCss":".mint-aspect-video {\n aspect-ratio: 16 / 9\n}\n.mint-w-full {\n width: 100%\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}\n.mint-border-0 {\n border-width: 0px\n}","subdomain":"hcompany","siteName":"H Platform Docs","title":"Agents API - H Platform Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-14T14:34:40.684Z","gitLastModified":"2026-09-11T00:27:53.000Z","originalFileLocation":"agents-api/introduction.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=\"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.\">\u003cmeta data-mint-head name=\"application-name\" content=\"H Platform Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_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/hcompany/nM3pPP_yLXYJU6-f/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agents API - H Platform Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"The Agents API runs Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults, webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"H Platform Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://hub.hcompany.ai/agents-api/introduction\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hcompany.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agents+API\u0026amp;description=Run+Holo-powered+computer-use+agents+that+do+work+in+a+cloud+browser+or+on+a+desktop%3A+pre-built+agents%2C+custom+agents%2C+live+sessions%2C+skills%2C+vaults.\u0026amp;theme=3fdb93a2673ae40d7c89743e\u0026amp;signature=55257a9c0cd3b1079a3677f02e3e2e853f04d33e2a7eff580004350fa338b3d3\">\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=\"Agents API - H Platform Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The Agents API runs Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults, webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hcompany.mintlify.app/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agents+API\u0026amp;description=Run+Holo-powered+computer-use+agents+that+do+work+in+a+cloud+browser+or+on+a+desktop%3A+pre-built+agents%2C+custom+agents%2C+live+sessions%2C+skills%2C+vaults.\u0026amp;theme=3fdb93a2673ae40d7c89743e\u0026amp;signature=55257a9c0cd3b1079a3677f02e3e2e853f04d33e2a7eff580004350fa338b3d3\">\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/hcompany/nM3pPP_yLXYJU6-f/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"H Platform Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1d1d1f\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://hub.hcompany.ai/agents-api/introduction\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/agents-api/introduction.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://hcompany.ai/#organization\",\"name\":\"H Company\",\"url\":\"https://hcompany.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hcompany/vPduESIuGEAUuxP5/images/logo-light.svg?fit=max\u0026auto=format\u0026n=vPduESIuGEAUuxP5\u0026q=85\u0026s=a39948dec920a4705f038b3ded597245\"},\"sameAs\":[\"https://x.com/hcompany_ai\",\"https://www.linkedin.com/company/h-company-ai\",\"https://github.com/hcompai\",\"https://huggingface.co/Hcompany\"]},{\"@type\":\"WebSite\",\"@id\":\"https://hub.hcompany.ai#website\",\"name\":\"H Platform Docs\",\"url\":\"https://hub.hcompany.ai\",\"publisher\":{\"@id\":\"https://hcompany.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://hub.hcompany.ai/agents-api/introduction#webpage\",\"url\":\"https://hub.hcompany.ai/agents-api/introduction\",\"name\":\"Agents API\",\"description\":\"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.\",\"dateModified\":\"2026-09-11T00:27:53.000Z\",\"isPartOf\":{\"@id\":\"https://hub.hcompany.ai#website\"},\"breadcrumb\":{\"@id\":\"https://hub.hcompany.ai/agents-api/introduction#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://hub.hcompany.ai/agents-api/introduction#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"H Platform Docs\",\"item\":\"https://hub.hcompany.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents API\",\"item\":\"https://hub.hcompany.ai/agents-api/introduction\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://hub.hcompany.ai/agents-api/introduction#article\",\"headline\":\"Agents API\",\"name\":\"Agents API\",\"description\":\"Run Holo-powered computer-use agents that do work in a cloud browser or on a desktop: pre-built agents, custom agents, live sessions, skills, vaults.\",\"url\":\"https://hub.hcompany.ai/agents-api/introduction\",\"mainEntityOfPage\":{\"@id\":\"https://hub.hcompany.ai/agents-api/introduction#webpage\"},\"dateModified\":\"2026-09-11T00:27:53.000Z\",\"keywords\":\"computer-use agent API, browser agent, desktop agent, web automation, Holo\",\"publisher\":{\"@id\":\"https://hcompany.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://hub.hcompany.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"H Platform Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"H Platform Docs","nav":{"global":null,"tabs":[{"tab":"Welcome","hidden":true,"searchable":true,"pages":[{"title":"Welcome","href":""}]},{"tab":"Agents API","dropdowns":[{"dropdown":"Documentation","icon":"book-open","pages":[{"group":"Get started","pages":[{"title":"Agents API","sidebarTitle":"Introduction","href":"/agents-api/introduction"},{"title":"Agents API quickstart","description":"Get an API key, install the hai-agents SDK or CLI, run a pre-built computer-use agent with one call, then create your own agent.","sidebarTitle":"Quickstart","href":"/agents-api/quickstart"},{"title":"Run agents on your own machine","sidebarTitle":"Local mode","href":"/agents-api/local-mode"},{"title":"Run the model on your own GPUs","sidebarTitle":"Your own GPUs","href":"/agents-api/local-inference"},{"title":"Run from the platform","href":"/agents-api/run-from-the-platform"}]},{"group":"Concepts","pages":[{"title":"Agents","sidebarTitle":"Agents","href":"/agents-api/agents/overview"},{"title":"Environments","sidebarTitle":"Environments","href":"/agents-api/environments/overview"},{"title":"Sessions","sidebarTitle":"Sessions","href":"/agents-api/sessions/overview"},{"title":"Skills","sidebarTitle":"Skills","href":"/agents-api/skills/overview"},{"title":"Vaults","sidebarTitle":"Vaults","href":"/agents-api/vaults/overview"}]},{"group":"Browser and desktop","pages":[{"title":"Configure the browser","href":"/agents-api/browser/configuration"},{"title":"Browser profiles","href":"/agents-api/browser/profiles"},{"title":"Route the browser through a proxy","sidebarTitle":"Route through a proxy","href":"/agents-api/browser/proxy"},{"title":"Local control","sidebarTitle":"Local control","href":"/agents-api/local-control"}]},{"group":"Integrations","pages":[{"title":"Build with the SDKs","href":"/agents-api/sdks"},{"title":"Run agents over MCP","href":"/agents-api/mcp"},{"title":"Build with coding assistants","href":"/agents-api/coding-skills"},{"title":"Run agents from n8n","href":"/agents-api/n8n"}]},{"group":"Guides","pages":[{"title":"Parallelize work with subagents","href":"/agents-api/multi-agent"},{"title":"Watch and steer sessions","href":"/agents-api/observe-and-steer"},{"title":"Give an agent custom tools","href":"/agents-api/custom-tools"},{"title":"Handle two-factor authentication","href":"/agents-api/two-factor-auth"},{"title":"Get typed answers","href":"/agents-api/structured-output"},{"title":"Optimize for speed","href":"/agents-api/optimize-for-speed"}]},{"group":"Operate","pages":[{"title":"Get notified with webhooks","sidebarTitle":"Webhooks","href":"/agents-api/webhooks/overview"},{"title":"Run sessions on a schedule","sidebarTitle":"Schedules","href":"/agents-api/schedules/overview"},{"title":"Plans and limits","href":"/agents-api/plans-and-limits"},{"title":"Handle API errors","sidebarTitle":"Errors","href":"/agents-api/errors"}]},{"title":"Changelog","sidebarTitle":"Changelog","href":"/agents-api/changelog"}]},{"dropdown":"API reference","icon":"code","pages":[{"title":"API reference","href":"/agents-api/api-reference"},{"group":"Agents","pages":[{"title":"Create an agent","sidebarTitle":"Create","api":"POST /api/v2/agents","href":"/agents-api/agents/create"},{"title":"List agents","sidebarTitle":"List","api":"GET /api/v2/agents","href":"/agents-api/agents/list"},{"title":"Retrieve an agent","sidebarTitle":"Retrieve","api":"GET /api/v2/agents/{agent_name}","href":"/agents-api/agents/retrieve"},{"title":"Update an agent","sidebarTitle":"Update","api":"PUT /api/v2/agents/{agent_name}","href":"/agents-api/agents/update"},{"title":"Patch an agent","sidebarTitle":"Patch","api":"PATCH /api/v2/agents/{agent_name}","href":"/agents-api/agents/patch"},{"title":"Delete an agent","sidebarTitle":"Delete","api":"DELETE /api/v2/agents/{agent_name}","href":"/agents-api/agents/delete"},{"title":"List agent revisions","sidebarTitle":"List revisions","api":"GET /api/v2/agents/{agent_name}/revisions","href":"/agents-api/agents/list-revisions"},{"title":"Restore an agent revision","sidebarTitle":"Restore revision","api":"POST /api/v2/agents/{agent_name}/revisions/{number}/restore","href":"/agents-api/agents/restore-revision"}]},{"group":"Environments","pages":[{"title":"Create an environment","sidebarTitle":"Create","api":"POST /api/v2/environments","href":"/agents-api/environments/create"},{"title":"List environments","sidebarTitle":"List","api":"GET /api/v2/environments","href":"/agents-api/environments/list"},{"title":"Retrieve an environment","sidebarTitle":"Retrieve","api":"GET /api/v2/environments/{id}","href":"/agents-api/environments/retrieve"},{"title":"Update an environment","sidebarTitle":"Update","api":"PUT /api/v2/environments/{id}","href":"/agents-api/environments/update"},{"title":"Patch an environment","sidebarTitle":"Patch","api":"PATCH /api/v2/environments/{id}","href":"/agents-api/environments/patch"},{"title":"Delete an environment","sidebarTitle":"Delete","api":"DELETE /api/v2/environments/{id}","href":"/agents-api/environments/delete"}]},{"group":"Sessions","pages":[{"title":"Create a session","sidebarTitle":"Create","api":"POST /api/v2/sessions","href":"/agents-api/sessions/create"},{"title":"List sessions","sidebarTitle":"List","api":"GET /api/v2/sessions","href":"/agents-api/sessions/list"},{"title":"Retrieve a session","sidebarTitle":"Retrieve","api":"GET /api/v2/sessions/{id}","href":"/agents-api/sessions/retrieve"},{"title":"Get session status","sidebarTitle":"Status","api":"GET /api/v2/sessions/{id}/status","href":"/agents-api/sessions/status"},{"title":"Get session changes","sidebarTitle":"Changes","api":"GET /api/v2/sessions/{id}/changes","href":"/agents-api/sessions/changes"},{"title":"List events","sidebarTitle":"Events","api":"GET /api/v2/sessions/{id}/events","href":"/agents-api/sessions/events"},{"title":"Send messages","sidebarTitle":"Messages","api":"POST /api/v2/sessions/{id}/messages","href":"/agents-api/sessions/send-messages"},{"title":"Send tool results","sidebarTitle":"Tool results","api":"POST /api/v2/sessions/{id}/tool_results","href":"/agents-api/sessions/tool-results"},{"title":"Pause a session","sidebarTitle":"Pause","api":"POST /api/v2/sessions/{id}/pause","href":"/agents-api/sessions/pause"},{"title":"Resume a session","sidebarTitle":"Resume","api":"POST /api/v2/sessions/{id}/resume","href":"/agents-api/sessions/resume"},{"title":"Force an answer","sidebarTitle":"Force answer","api":"POST /api/v2/sessions/{id}/force_answer","href":"/agents-api/sessions/force-answer"},{"title":"Cancel a session","sidebarTitle":"Cancel","api":"DELETE /api/v2/sessions/{id}","href":"/agents-api/sessions/cancel"},{"title":"Get quota","sidebarTitle":"Quota","api":"GET /api/v2/sessions/quota","href":"/agents-api/sessions/quota"},{"title":"Session feedback","sidebarTitle":"Feedback","api":"POST /api/v2/sessions/{id}/feedback","href":"/agents-api/sessions/feedback"},{"title":"Event feedback","sidebarTitle":"Event feedback","api":"PUT /api/v2/sessions/{id}/events/{event_index}/feedback","href":"/agents-api/sessions/event-feedback"},{"title":"Share a session","sidebarTitle":"Share","api":"POST /api/v2/sessions/{id}/share","href":"/agents-api/sessions/share"},{"title":"Unshare a session","sidebarTitle":"Unshare","api":"DELETE /api/v2/sessions/{id}/share","href":"/agents-api/sessions/unshare"},{"title":"Get resource","sidebarTitle":"Resources","api":"GET /api/v2/sessions/{id}/resources/{bucket}/{key}","href":"/agents-api/sessions/resources"},{"title":"List files","sidebarTitle":"List files","api":"POST /api/v2/sessions/{session_id}/files/list_files","href":"/agents-api/sessions/list-files"},{"title":"Read file","sidebarTitle":"Read file","api":"POST /api/v2/sessions/{session_id}/files/read_file","href":"/agents-api/sessions/read-file"},{"title":"Write file","sidebarTitle":"Write file","api":"POST /api/v2/sessions/{session_id}/files/write_file","href":"/agents-api/sessions/write-file"}]},{"group":"Skills","pages":[{"title":"Create a skill","sidebarTitle":"Create","api":"POST /api/v2/skills","href":"/agents-api/skills/create"},{"title":"List skills","sidebarTitle":"List","api":"GET /api/v2/skills","href":"/agents-api/skills/list"},{"title":"Retrieve a skill","sidebarTitle":"Retrieve","api":"GET /api/v2/skills/{name}","href":"/agents-api/skills/retrieve"},{"title":"Update a skill","sidebarTitle":"Update","api":"PUT /api/v2/skills/{name}","href":"/agents-api/skills/update"},{"title":"Patch a skill","sidebarTitle":"Patch","api":"PATCH /api/v2/skills/{name}","href":"/agents-api/skills/patch"},{"title":"Delete a skill","sidebarTitle":"Delete","api":"DELETE /api/v2/skills/{name}","href":"/agents-api/skills/delete"}]},{"group":"Vaults","pages":[{"title":"Create a vault","sidebarTitle":"Create","api":"POST /api/v2/vaults","href":"/agents-api/vaults/create"},{"title":"List vaults","sidebarTitle":"List","api":"GET /api/v2/vaults","href":"/agents-api/vaults/list"},{"title":"Retrieve a vault","sidebarTitle":"Retrieve","api":"GET /api/v2/vaults/{vault_id}","href":"/agents-api/vaults/retrieve"},{"title":"Update a vault","sidebarTitle":"Update","api":"PATCH /api/v2/vaults/{vault_id}","href":"/agents-api/vaults/update"},{"title":"Rotate the token","sidebarTitle":"Rotate token","api":"PUT /api/v2/vaults/{vault_id}/token","href":"/agents-api/vaults/rotate-token"},{"title":"Delete a vault","sidebarTitle":"Delete","api":"DELETE /api/v2/vaults/{vault_id}","href":"/agents-api/vaults/delete"},{"title":"Check health","sidebarTitle":"Health","api":"GET /api/v2/vaults/{vault_id}/health","href":"/agents-api/vaults/health"}]},{"group":"Browser Profiles","pages":[{"title":"List browser profiles","sidebarTitle":"List","api":"GET /api/v2/browser-profiles","href":"/agents-api/browser-profiles/list"},{"title":"Initiate a profile upload","sidebarTitle":"Initiate upload","api":"POST /api/v2/browser-profiles/initiate-upload","href":"/agents-api/browser-profiles/initiate-upload"},{"title":"Complete a profile upload","sidebarTitle":"Complete upload","api":"POST /api/v2/browser-profiles/{profile_id}/complete-upload","href":"/agents-api/browser-profiles/complete-upload"},{"title":"Retrieve a browser profile","sidebarTitle":"Retrieve","api":"GET /api/v2/browser-profiles/{profile_id}","href":"/agents-api/browser-profiles/retrieve"},{"title":"Delete a browser profile","sidebarTitle":"Delete","api":"DELETE /api/v2/browser-profiles/{profile_id}","href":"/agents-api/browser-profiles/delete"},{"title":"Set the default browser profile","sidebarTitle":"Set default","api":"PUT /api/v2/browser-profiles/{profile_id}/default","href":"/agents-api/browser-profiles/set-default"},{"title":"Get the default browser profile","sidebarTitle":"Get default","api":"GET /api/v2/browser-profiles/default","href":"/agents-api/browser-profiles/get-default"},{"title":"Unset the default browser profile","sidebarTitle":"Unset default","api":"DELETE /api/v2/browser-profiles/{profile_id}/default","href":"/agents-api/browser-profiles/unset-default"}]},{"group":"Webhooks","pages":[{"title":"Create a webhook","sidebarTitle":"Create","api":"POST /api/v2/webhooks","href":"/agents-api/webhooks/create"},{"title":"List webhooks","sidebarTitle":"List","api":"GET /api/v2/webhooks","href":"/agents-api/webhooks/list"},{"title":"Retrieve a webhook","sidebarTitle":"Retrieve","api":"GET /api/v2/webhooks/{webhook_id}","href":"/agents-api/webhooks/retrieve"},{"title":"Update a webhook","sidebarTitle":"Update","api":"PATCH /api/v2/webhooks/{webhook_id}","href":"/agents-api/webhooks/update"},{"title":"Delete a webhook","sidebarTitle":"Delete","api":"DELETE /api/v2/webhooks/{webhook_id}","href":"/agents-api/webhooks/delete"},{"title":"List event types","sidebarTitle":"Event types","api":"GET /api/v2/webhooks/events","href":"/agents-api/webhooks/events"},{"title":"Ping a webhook","sidebarTitle":"Ping","api":"POST /api/v2/webhooks/{webhook_id}/ping","href":"/agents-api/webhooks/ping"},{"title":"Rotate a webhook secret","sidebarTitle":"Rotate secret","api":"POST /api/v2/webhooks/{webhook_id}/rotate","href":"/agents-api/webhooks/rotate"}]},{"group":"Schedules","pages":[{"title":"Create a schedule","sidebarTitle":"Create","api":"POST /api/v2/schedules","href":"/agents-api/schedules/create"},{"title":"List schedules","sidebarTitle":"List","api":"GET /api/v2/schedules","href":"/agents-api/schedules/list"},{"title":"Retrieve a schedule","sidebarTitle":"Retrieve","api":"GET /api/v2/schedules/{schedule_id}","href":"/agents-api/schedules/retrieve"},{"title":"Update a schedule","sidebarTitle":"Update","api":"PATCH /api/v2/schedules/{schedule_id}","href":"/agents-api/schedules/update"},{"title":"Delete a schedule","sidebarTitle":"Delete","api":"DELETE /api/v2/schedules/{schedule_id}","href":"/agents-api/schedules/delete"},{"title":"Pause a schedule","sidebarTitle":"Pause","api":"POST /api/v2/schedules/{schedule_id}/pause","href":"/agents-api/schedules/pause"},{"title":"Resume a schedule","sidebarTitle":"Resume","api":"POST /api/v2/schedules/{schedule_id}/resume","href":"/agents-api/schedules/resume"},{"title":"Trigger a schedule","sidebarTitle":"Trigger","api":"POST /api/v2/schedules/{schedule_id}/trigger","href":"/agents-api/schedules/trigger"},{"title":"List schedule runs","sidebarTitle":"Runs","api":"GET /api/v2/schedules/{schedule_id}/runs","href":"/agents-api/schedules/runs"}]}]}]},{"tab":"Models API","dropdowns":[{"dropdown":"Documentation","icon":"book-open","pages":[{"group":"Get started","pages":[{"title":"Models API","sidebarTitle":"Introduction","href":"/models-api/introduction"},{"title":"Models API quickstart","sidebarTitle":"Quickstart","href":"/models-api/quickstart"}]},{"group":"Build an agent","pages":[{"title":"Core concepts","href":"/models-api/build-an-agent/core-concepts"},{"title":"Function calling","href":"/models-api/build-an-agent/function-calling"},{"title":"Structured outputs","href":"/models-api/build-an-agent/structured-outputs"}]},{"group":"Cookbooks","pages":[{"title":"Browser agent","href":"/models-api/cookbooks/browser-agent"},{"title":"Code agent","href":"/models-api/cookbooks/code-agent"},{"title":"MCP agent","href":"/models-api/cookbooks/mcp-agent"},{"title":"Hybrid agent","href":"/models-api/cookbooks/hybrid-agent"}]},{"group":"Guides","pages":[{"title":"Element localization","href":"/models-api/element-localization"},{"title":"Document OCR","href":"/models-api/document-ocr"}]},{"group":"Self-host","pages":[{"title":"Local inference","href":"/models-api/local-inference"}]}]},{"dropdown":"API reference","icon":"code","pages":[{"title":"API reference","href":"/models-api/api-reference"},{"group":"Endpoints","pages":[{"title":"Create chat completion","sidebarTitle":"Chat completions","api":"POST https://api.hcompany.ai/v1/chat/completions","href":"/models-api/chat-completions"},{"title":"List models","sidebarTitle":"List models","api":"GET https://api.hcompany.ai/v1/models","href":"/models-api/list-models"}]}]}]},{"tab":"HoloTab","pages":[{"title":"HoloTab","href":"/holotab/introduction"}]},{"tab":"HoloDesktop CLI","pages":[{"title":"HoloDesktop CLI","href":"/holo-desktop-cli/introduction"}]},{"tab":"Docs MCP","hidden":true,"searchable":true,"pages":[{"title":"Docs MCP","href":"/docs-mcp-server"}]}]},"title":"Agents API - H Platform Docs","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["07c022d89b"],"chunks":["Frame-B0bJ23PC.js","DynamicMarkdown-UGQuxDKp.js"]}