{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"2501.ai","colors":{"primary":"#121212","light":"#FAFAFA","dark":"#121212"},"logo":{"light":"https://mintcdn.com/2501/gMl_w8qww9Zl47hO/logo/light.png?fit=max\u0026auto=format\u0026n=gMl_w8qww9Zl47hO\u0026q=85\u0026s=eeeb37b3ca386a00dde53b3e6235adce","dark":"https://mintcdn.com/2501/gMl_w8qww9Zl47hO/logo/dark.png?fit=max\u0026auto=format\u0026n=gMl_w8qww9Zl47hO\u0026q=85\u0026s=4d0ac2514d479eb43fe361193d12c495","href":"/0.7/getting-started/welcome"},"favicon":"https://mintcdn.com/2501/gMl_w8qww9Zl47hO/favicon.png?fit=max\u0026auto=format\u0026n=gMl_w8qww9Zl47hO\u0026q=85\u0026s=884be98d09b5672f470de49ac6430f22","appearance":{"default":"light"},"background":{"color":{"light":"#FAFAFA","dark":"#121212"}},"navbar":{"links":[{"href":"mailto:hello@2501.ai","label":"Contact"},{"href":"https://github.com/2501-ai","label":"Github"},{"href":"https://2501.ai/","label":"Website"}]},"footer":{"socials":{"website":"https://www.2501.ai/","github":"https://github.com/2501-ai","linkedin":"https://www.linkedin.com/company/99099126"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"2501","hasAudioNarration":false,"actualSubdomain":"2501","customDomains":["docs.2501.ai"],"gitSource":{"type":"github","owner":"2501-ai","repo":"2501","deployBranch":"main","contentDirectory":"apps/public-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb789e343e8b4158149ec1","collectionId":"0af6326e-772b-4544-a2c9-971455444f68","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb789e343e8b4158149ec1"},"entitlements":{},"buildId":"6adb789e343e8b4158149ec1","clientVersion":"0.0.3939","searchFilterCounts":[{"language":"default","tag":"Reference","count":843},{"language":"default","tag":"API","count":405},{"language":"default","tag":"Configure","count":286},{"language":"default","tag":"Guides","count":180},{"language":"default","tag":"Docs","count":173},{"language":"default","tag":"Benchmark","count":165},{"language":"default","tag":"Integration","count":117},{"language":"default","tag":"Deploy","count":112},{"language":"default","tag":"Agents","count":104},{"language":"default","tag":"Concepts","count":101}]},"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":[],"page":{"pagePath":"0.2.6/api-reference/agents/post--agents","slug":"/0.2.6/api-reference/agents/post--agents","pageMetadata":{"openapi":"post /agents","title":null,"description":null,"href":"/0.2.6/api-reference/agents/post--agents"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /agents","title":null,"description":null,"href":"/0.2.6/api-reference/agents/post--agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"2501","siteName":"2501.ai","title":"Post agents - 2501.ai","navMaps":{"firstHrefInVersion":{"0.18":{"href":"/0.2.6/api-reference/agents/post--agents","matchLevel":0},"0.17":{"href":"/0.17/getting-started/welcome","matchLevel":4},"0.16":{"href":"/0.16/getting-started/welcome","matchLevel":4},"0.15":{"href":"/0.15/getting-started/welcome","matchLevel":4},"0.14":{"href":"/0.14/getting-started/welcome","matchLevel":4},"0.13":{"href":"/0.13/getting-started/welcome","matchLevel":4},"0.12":{"href":"/0.12/getting-started/welcome","matchLevel":4},"0.11":{"href":"/0.11/getting-started/welcome","matchLevel":4},"0.10":{"href":"/0.10/getting-started/welcome","matchLevel":4},"0.9":{"href":"/0.9/getting-started/welcome","matchLevel":4},"0.8":{"href":"/0.8/getting-started/welcome","matchLevel":4},"0.7":{"href":"/0.7/getting-started/welcome","matchLevel":4},"0.4":{"href":"/0.4/command-center","matchLevel":4},"0.3.0":{"href":"/0.3.0/command-center","matchLevel":4},"0.2.6":{"href":"/0.2.6/command-center","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-10-19T16:20:29.272Z","originalFileLocation":"0.2.6/api-reference/agents/post--agents.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=\"light\"}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=\"application-name\" content=\"2501.ai\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_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/2501/ur2ley-wQyHAsGwc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Post agents - 2501.ai\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"2501.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.2501.ai/0.2.6/api-reference/agents/post--agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://2501.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Post++agents\u0026amp;theme=844806e124fa9d0934ee6607\u0026amp;signature=4d678256576b4b103e5e96292fb9510631602bb528ac2359d7d1ae28b1548d6f\">\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=\"Post agents - 2501.ai\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://2501.mintlify.app/_mintlify/api/og/v2?division=Documentation\u0026amp;title=Post++agents\u0026amp;theme=844806e124fa9d0934ee6607\u0026amp;signature=4d678256576b4b103e5e96292fb9510631602bb528ac2359d7d1ae28b1548d6f\">\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/2501/ur2ley-wQyHAsGwc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"2501.ai\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#121212\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.2501.ai/0.2.6/api-reference/agents/post--agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/0.2.6/api-reference/agents/post--agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"2501.ai\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"2501.ai","nav":{"global":null,"versions":[{"version":"0.18","tabs":[{"tab":"Docs","groups":[{"group":"Getting Started","pages":[{"title":"Welcome","href":"/0.18/getting-started/welcome"},{"title":"Quickstart","href":"/0.18/getting-started/quickstart"}]},{"group":"Understand 2501","pages":[{"title":"Command Center","href":"/0.18/understand/command-center"},{"title":"Engine \u0026 Agents","href":"/0.18/understand/engine-agents"},{"title":"Agentic Flow","href":"/0.18/understand/agentic-flow"},{"title":"Configuration Approaches","href":"/0.18/understand/configuration"}]},{"group":"Concepts","pages":[{"title":"Agents","href":"/0.18/core-concepts/agents"},{"title":"Hosts","href":"/0.18/core-concepts/hosts"},{"title":"Clusters","href":"/0.18/core-concepts/clusters"},{"title":"Central","href":"/0.18/core-concepts/central"},{"title":"Organizations","href":"/0.18/core-concepts/organizations"},{"title":"Tickets","href":"/0.18/core-concepts/tickets"},{"title":"Tasks","href":"/0.18/core-concepts/tasks"},{"title":"Jobs","href":"/0.18/core-concepts/jobs"},{"title":"Job Schedules","href":"/0.18/core-concepts/job-schedules"},{"title":"Gateways","href":"/0.18/core-concepts/gateways"},{"title":"MCP \u0026 Plugins","href":"/0.18/core-concepts/plugins"},{"title":"Observability","href":"/0.18/core-concepts/observability"}]}]},{"tab":"Reference","groups":[{"group":"API","pages":[{"title":"API Overview","href":"/0.18/api/overview"},{"group":"Plugins","pages":[{"title":"List plugins","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/plugins","href":"/0.18/api-reference/plugins/list-plugins"},{"title":"Create a plugin","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/plugins","href":"/0.18/api-reference/plugins/create-a-plugin"},{"title":"Search plugins","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/plugins/search","href":"/0.18/api-reference/plugins/search-plugins"},{"title":"Get a plugin","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/plugins/{id}","href":"/0.18/api-reference/plugins/get-a-plugin"},{"title":"Update a plugin","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/plugins/{id}","href":"/0.18/api-reference/plugins/update-a-plugin"},{"title":"Delete a plugin","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/plugins/{id}","href":"/0.18/api-reference/plugins/delete-a-plugin"},{"title":"List HTTP API documentation files","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/plugins/{id}/documents","href":"/0.18/api-reference/plugins/list-http-api-documentation-files"},{"title":"Upload or replace HTTP API documentation","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/plugins/{id}/documents","href":"/0.18/api-reference/plugins/upload-or-replace-http-api-documentation"},{"title":"Remove an HTTP API documentation file","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/plugins/{id}/documents/{documentId}","href":"/0.18/api-reference/plugins/remove-an-http-api-documentation-file"},{"title":"Read the OAuth account status of a plugin for an organization","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/plugins/{id}/oauth","href":"/0.18/api-reference/plugins/read-the-oauth-account-status-of-a-plugin-for-an-organization"},{"title":"Forget the authorization server a plugin trusts","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/plugins/{id}/oauth/trusted-issuer","href":"/0.18/api-reference/plugins/forget-the-authorization-server-a-plugin-trusts"}]},{"group":"Specialties","pages":[{"title":"List specialties","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/specialties","href":"/0.18/api-reference/specialties/list-specialties"},{"title":"Create a specialty","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/specialties","href":"/0.18/api-reference/specialties/create-a-specialty"},{"title":"Search specialties","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/specialties/search","href":"/0.18/api-reference/specialties/search-specialties"},{"title":"Get a specialty","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/specialties/{id}","href":"/0.18/api-reference/specialties/get-a-specialty"},{"title":"Update a specialty","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/specialties/{id}","href":"/0.18/api-reference/specialties/update-a-specialty"},{"title":"Delete a specialty","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/specialties/{id}","href":"/0.18/api-reference/specialties/delete-a-specialty"},{"title":"Count what references a specialty","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/specialties/{id}/references","href":"/0.18/api-reference/specialties/count-what-references-a-specialty"}]},{"group":"Blacklists","pages":[{"title":"List blacklisted commands","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/blacklists","href":"/0.18/api-reference/blacklists/list-blacklisted-commands"},{"title":"Create a blacklisted command","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/blacklists","href":"/0.18/api-reference/blacklists/create-a-blacklisted-command"},{"title":"Search blacklisted commands","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/blacklists/search","href":"/0.18/api-reference/blacklists/search-blacklisted-commands"},{"title":"Get a blacklisted command","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/blacklists/{id}","href":"/0.18/api-reference/blacklists/get-a-blacklisted-command"},{"title":"Update a blacklisted command","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/blacklists/{id}","href":"/0.18/api-reference/blacklists/update-a-blacklisted-command"},{"title":"Delete a blacklisted command","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/blacklists/{id}","href":"/0.18/api-reference/blacklists/delete-a-blacklisted-command"}]},{"group":"Organizations","pages":[{"title":"List organizations","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/organizations","href":"/0.18/api-reference/organizations/list-organizations"},{"title":"Get an organization","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/organizations/{id}","href":"/0.18/api-reference/organizations/get-an-organization"}]},{"group":"Gateways","pages":[{"title":"List gateways","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/gateways","href":"/0.18/api-reference/gateways/list-gateways"},{"title":"Create a gateway","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/gateways","href":"/0.18/api-reference/gateways/create-a-gateway"},{"title":"Search gateways","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/gateways/search","href":"/0.18/api-reference/gateways/search-gateways"},{"title":"Get a gateway","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/gateways/{id}","href":"/0.18/api-reference/gateways/get-a-gateway"},{"title":"Update a gateway","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/gateways/{id}","href":"/0.18/api-reference/gateways/update-a-gateway"},{"title":"Delete a gateway","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/gateways/{id}","href":"/0.18/api-reference/gateways/delete-a-gateway"},{"title":"Count what references a gateway","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/gateways/{id}/references","href":"/0.18/api-reference/gateways/count-what-references-a-gateway"}]},{"group":"Hosts","pages":[{"title":"List hosts","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/hosts","href":"/0.18/api-reference/hosts/list-hosts"},{"title":"Create a host","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/hosts","href":"/0.18/api-reference/hosts/create-a-host"},{"title":"Search hosts","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/hosts/search","href":"/0.18/api-reference/hosts/search-hosts"},{"title":"Bulk import hosts","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/hosts/batch","href":"/0.18/api-reference/hosts/bulk-import-hosts"},{"title":"Bulk export hosts","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/hosts/export","href":"/0.18/api-reference/hosts/bulk-export-hosts"},{"title":"Get a host","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/hosts/{id}","href":"/0.18/api-reference/hosts/get-a-host"},{"title":"Update a host","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/hosts/{id}","href":"/0.18/api-reference/hosts/update-a-host"},{"title":"Delete a host","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/hosts/{id}","href":"/0.18/api-reference/hosts/delete-a-host"},{"title":"List a host agents","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/hosts/{id}/agents","href":"/0.18/api-reference/hosts/list-a-host-agents"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents","href":"/0.18/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents","href":"/0.18/api-reference/agents/create-an-agent"},{"title":"Search agents","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/search","href":"/0.18/api-reference/agents/search-agents"},{"title":"Bulk import agents","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/batch","href":"/0.18/api-reference/agents/bulk-import-agents"},{"title":"Bulk export agents","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/export","href":"/0.18/api-reference/agents/bulk-export-agents"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/{id}","href":"/0.18/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}","href":"/0.18/api-reference/agents/update-an-agent"},{"title":"Archive an agent","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/archive","href":"/0.18/api-reference/agents/archive-an-agent"},{"title":"Archive idle tasks","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/archive-tasks","href":"/0.18/api-reference/agents/archive-idle-tasks"},{"title":"List an agent tasks","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/{id}/tasks","href":"/0.18/api-reference/agents/list-an-agent-tasks"},{"title":"Test the connection","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/test-connection","href":"/0.18/api-reference/agents/test-the-connection"},{"title":"List an agent plugins","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/{id}/plugins","href":"/0.18/api-reference/agents/list-an-agent-plugins"},{"title":"Save a plugin assignment","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/plugins","href":"/0.18/api-reference/agents/save-a-plugin-assignment"},{"title":"Replace an agent's plugin assignments","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/replace-plugins","href":"/0.18/api-reference/agents/replace-an-agents-plugin-assignments"},{"title":"Read one plugin assignment","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.18/api-reference/agents/read-one-plugin-assignment"},{"title":"Detach a plugin","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.18/api-reference/agents/detach-a-plugin"},{"title":"Check an assigned plugin connection","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/agents/{id}/plugins/{pluginId}/check","href":"/0.18/api-reference/agents/check-an-assigned-plugin-connection"}]},{"group":"Credentials","pages":[{"title":"List credentials","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/credentials","href":"/0.18/api-reference/credentials/list-credentials"},{"title":"Create a credential","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/credentials","href":"/0.18/api-reference/credentials/create-a-credential"},{"title":"Search credentials","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/credentials/search","href":"/0.18/api-reference/credentials/search-credentials"},{"title":"Get a credential","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/credentials/{id}","href":"/0.18/api-reference/credentials/get-a-credential"},{"title":"Update a credential","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/credentials/{id}","href":"/0.18/api-reference/credentials/update-a-credential"},{"title":"Delete a credential","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/credentials/{id}","href":"/0.18/api-reference/credentials/delete-a-credential"},{"title":"Get credential usage","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/credentials/{id}/references","href":"/0.18/api-reference/credentials/get-credential-usage"}]},{"group":"Operational Rules","pages":[{"title":"List operational rules","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/operational-rules","href":"/0.18/api-reference/operational-rules/list-operational-rules"},{"title":"Create an operational rule","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/operational-rules","href":"/0.18/api-reference/operational-rules/create-an-operational-rule"},{"title":"Search operational rules","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/operational-rules/search","href":"/0.18/api-reference/operational-rules/search-operational-rules"},{"title":"Get an operational rule","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/operational-rules/{id}","href":"/0.18/api-reference/operational-rules/get-an-operational-rule"},{"title":"Update an operational rule","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/operational-rules/{id}","href":"/0.18/api-reference/operational-rules/update-an-operational-rule"},{"title":"Delete an operational rule","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/operational-rules/{id}","href":"/0.18/api-reference/operational-rules/delete-an-operational-rule"}]},{"group":"Scenarios","pages":[{"title":"List scenarios","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/scenarios","href":"/0.18/api-reference/scenarios/list-scenarios"},{"title":"Create a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/scenarios","href":"/0.18/api-reference/scenarios/create-a-scenario"},{"title":"Get a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/scenarios/{id}","href":"/0.18/api-reference/scenarios/get-a-scenario"},{"title":"Update a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/scenarios/{id}","href":"/0.18/api-reference/scenarios/update-a-scenario"},{"title":"Delete a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/scenarios/{id}","href":"/0.18/api-reference/scenarios/delete-a-scenario"},{"title":"Run a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/scenarios/{id}/run","href":"/0.18/api-reference/scenarios/run-a-scenario"},{"title":"List runs of a scenario","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/scenarios/{id}/runs","href":"/0.18/api-reference/scenarios/list-runs-of-a-scenario"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/scenarios/{id}/runs/{reportId}","href":"/0.18/api-reference/scenarios/get-a-run"},{"title":"Stop a run","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/scenarios/{id}/runs/{reportId}/stop","href":"/0.18/api-reference/scenarios/stop-a-run"}]},{"group":"Benchmarks","pages":[{"title":"List benchmarks","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/benchmarks","href":"/0.18/api-reference/benchmarks/list-benchmarks"},{"title":"Run a benchmark","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/benchmarks","href":"/0.18/api-reference/benchmarks/run-a-benchmark"},{"title":"Get a benchmark","deprecated":null,"version":null,"openapi":"/0.18/openapi.json get /api/v1/benchmarks/{id}","href":"/0.18/api-reference/benchmarks/get-a-benchmark"},{"title":"Delete a benchmark","deprecated":null,"version":null,"openapi":"/0.18/openapi.json delete /api/v1/benchmarks/{id}","href":"/0.18/api-reference/benchmarks/delete-a-benchmark"},{"title":"Cancel a benchmark","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/benchmarks/{id}/cancel","href":"/0.18/api-reference/benchmarks/cancel-a-benchmark"}]},{"group":"Signals","pages":[{"title":"Receive a Splunk alert","deprecated":null,"version":null,"openapi":"/0.18/openapi.json post /api/v1/signals","href":"/0.18/api-reference/signals/receive-a-splunk-alert"}]}]},{"group":"CLI","pages":[{"title":"2501 CLI","href":"/0.18/cli/overview"},{"title":"login \u0026 status","href":"/0.18/cli/login-status"},{"title":"infra","href":"/0.18/cli/infra"},{"title":"chat","href":"/0.18/cli/chat"}]},{"group":"Deploy","pages":[{"title":"Overview","href":"/0.18/deployment/overview"},{"title":"Init Command","href":"/0.18/deployment/init-command"},{"title":"Configuration","href":"/0.18/deployment/configuration"},{"title":"Docker Swarm","href":"/0.18/deployment/docker-swarm"},{"title":"Kubernetes","href":"/0.18/deployment/kubernetes"},{"title":"LLM Providers","href":"/0.18/deployment/llm-providers"},{"title":"Users \u0026 Organizations","href":"/0.18/deployment/users-organizations"},{"title":"Troubleshooting","href":"/0.18/deployment/troubleshooting"},{"title":"Feature Toggles","href":"/0.18/deployment/feature-toggles"},{"title":"Verify Image Signatures","href":"/0.18/deployment/verify-downloads"}]},{"group":"Configure","pages":[{"group":"Agent Behavior","pages":[{"title":"Specialties","href":"/0.18/configure/specialties"},{"title":"Operational Rules","href":"/0.18/configure/operational-rules"},{"title":"Blacklist","href":"/0.18/configure/blacklist"}]},{"title":"Clusters","href":"/0.18/configure/clusters"},{"title":"Plugins","href":"/0.18/configure/plugins"},{"title":"Central configurations","href":"/0.18/configure/centrals"},{"title":"Knowledge Base","href":"/0.18/configure/knowledge"},{"title":"Import and Export","href":"/0.18/configure/import-export"},{"group":"Access \u0026 Secrets","pages":[{"title":"Credentials","href":"/0.18/configure/credentials"},{"title":"API Keys","href":"/0.18/configure/api-keys"}]},{"group":"Integration","pages":[{"title":"Webhooks","href":"/0.18/configure/webhooks"},{"title":"Network Discovery","href":"/0.18/configure/discovery"}]},{"group":"LLM","pages":[{"title":"Providers","href":"/0.18/configure/providers"},{"title":"Models","href":"/0.18/configure/models"}]},{"title":"Users","href":"/0.18/configure/users"},{"title":"Licensing \u0026 Usage","href":"/0.18/configure/licensing"}]}]},{"tab":"Benchmark","groups":[{"group":"Get Started","pages":[{"title":"Why Benchmark","href":"/0.18/benchmark/overview"},{"title":"Quickstart","href":"/0.18/benchmark/quickstart"}]},{"group":"Build Scenarios","pages":[{"title":"Scenario reference","href":"/0.18/benchmark/scenario"},{"title":"Designing scenarios","href":"/0.18/benchmark/designing"},{"title":"Validation rules","href":"/0.18/benchmark/validation"},{"title":"Examples","href":"/0.18/benchmark/examples"}]},{"group":"Run \u0026 Maintain","pages":[{"title":"Benchmark in Command Center","href":"/0.18/benchmark/command-center"},{"title":"Reading results","href":"/0.18/benchmark/results"},{"title":"Keeping scenarios healthy","href":"/0.18/benchmark/maintaining"},{"title":"Benchmarks from the API","href":"/0.18/benchmark/api"}]}]},{"tab":"Guides","groups":[{"group":"Prompting","pages":[{"title":"Prompting","href":"/0.18/configure/prompting"},{"title":"Talking to an Agent","href":"/0.18/prompting/talking-to-agents"},{"title":"Prompting for a Specialty","href":"/0.18/prompting/specialty"},{"title":"Prompting an Operational Rule","href":"/0.18/prompting/operational-rule"},{"title":"Prompting a Gateway","href":"/0.18/prompting/gateway"}]},{"group":"Best Practices","pages":[{"title":"Scoping Agents","href":"/0.18/best-practices/scoping-agents"},{"title":"Working with Knowledge","href":"/0.18/best-practices/knowledge"},{"title":"Dynamic Context Injection","href":"/0.18/best-practices/dynamic-context"},{"title":"Shell, Central and plugins","href":"/0.18/best-practices/mcp-plugins"},{"title":"Testing a Behavior","href":"/0.18/best-practices/testing"}]},{"group":"Risk \u0026 Safety","pages":[{"title":"Handling Permissions","href":"/0.18/risk/permissions"},{"title":"Blacklists in Practice","href":"/0.18/risk/blacklists"},{"title":"Read-Only Agents","href":"/0.18/risk/read-only-agents"},{"title":"Benchmarking for Risk","href":"/0.18/risk/benchmarking"}]},{"group":"FAQ","pages":[{"title":"FAQ","href":"/0.18/faq"}]}]}]},{"version":"0.17","pages":[{"title":"0.17","href":"/0.17/getting-started/welcome"}]},{"version":"0.16","pages":[{"title":"0.16","href":"/0.16/getting-started/welcome"}]},{"version":"0.15","pages":[{"title":"0.15","href":"/0.15/getting-started/welcome"}]},{"version":"0.14","pages":[{"title":"0.14","href":"/0.14/getting-started/welcome"}]},{"version":"0.13","pages":[{"title":"0.13","href":"/0.13/getting-started/welcome"}]},{"version":"0.12","pages":[{"title":"0.12","href":"/0.12/getting-started/welcome"}]},{"version":"0.11","pages":[{"title":"0.11","href":"/0.11/getting-started/welcome"}]},{"version":"0.10","pages":[{"title":"0.10","href":"/0.10/getting-started/welcome"}]},{"version":"0.9","pages":[{"title":"0.9","href":"/0.9/getting-started/welcome"}]},{"version":"0.8","pages":[{"title":"0.8","href":"/0.8/getting-started/welcome"}]},{"version":"0.7","pages":[{"title":"0.7","href":"/0.7/getting-started/welcome"}]},{"version":"0.4","pages":[{"title":"0.4","href":"/0.4/command-center"}]},{"version":"0.3.0","pages":[{"title":"0.3.0","href":"/0.3.0/command-center"}]},{"version":"0.2.6","pages":[{"title":"0.2.6","href":"/0.2.6/command-center"}]}]},"title":"Post agents - 2501.ai","buildId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","deploymentId":"dpl_5UDDZ9hnigTkoV7QtvQ39eUp84nu","dynamics":["b0f84f53ff"],"chunks":["Page-DI3qcHCR.js","ApiExamples-C2tgFaZo.js","utils-CL-hnw0w.js","_Uint8Array-BIdfUDMD.js","isArray-9Clv05ut.js","cloneDeep-DEhA10yQ.js","utils-BPQHBzJf.js","toString-CsGphfAF.js","isEqual-D9eQogBc.js","usePlaygroundInputsStore-DlPWx985.js","shallow-Cy1-O-K-.js","snippetPresets-Bp4RNJqj.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","getApiPlaygroundDisplay-TySNWNCT.js","ChevronDownIcon-DS8mg5XA.js","CodeSnippet-xbbdoopp.js","CodeSnippets-B-oinCW8.js","getPastedJson-DZgYp_Pn.js","icon-C0KkyG1h.js","MethodPill-Daq3Ho47.js","DynamicMarkdown-BGu84FgU.js","addUniqueKeysToSchema-B7FhpkUB.js","SectionHeading-D_vgUW0k.js","ArrowRotateAnticlockwiseIcon-Bj7dfLwT.js","CircleWarningIcon-DYIl5eC3.js","PlusIcon-DXkY3IBj.js","TrashIcon-5oDe3XeZ.js","axios-vUo_bRtp.js"]}
