An API key minted in Command Center (Settings -> API Keys), sent as Authorization: Bearer 2501_ak_.... A Command Center session cookie is also accepted.
{"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":"6ae06382dc8e261a8bb5a8cf","collectionId":"1211b02f-18ff-4e53-923a-18bdb4bcf20b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae06382dc8e261a8bb5a8cf"},"entitlements":{},"buildId":"6ae0a05db64cd9c8a5d3b5de","clientVersion":"0.0.3971","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":{},"basePath":"","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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"0.14/api-reference/hosts/update-a-host","slug":"/0.14/api-reference/hosts/update-a-host","pageMetadata":{"title":"Update a host","description":"Partial update - only the fields in the body change.","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/hosts/{id}","href":"/0.14/api-reference/hosts/update-a-host","autogeneratedByOpenApi":true},"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: \"Partial update - only the fields in the body change.\"\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}=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":{"title":"Update a host","description":"Partial update - only the fields in the body change.","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/hosts/{id}","href":"/0.14/api-reference/hosts/update-a-host","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Hosts"],"summary":"Update a host","description":"Partial update - only the fields in the body change.","parameters":["e6451d60-3f7f-449a-be14-8c1c9873f416"],"requestBody":"66270960-ce53-4066-b252-56f0743ff7c0","responses":{"200":"3ebeaf38-1529-41b9-a626-053acfb0ddc2","400":"8d2b22c2-332a-4895-b179-ee447fd273c1","401":"3ebde1f1-0709-4a0c-a4ca-0e48c51e1d95","403":"3b873997-cd62-42f8-851a-e705a9a2ca37","404":"fab38898-b15c-451b-9d1d-4f541acc4978"},"method":"post","type":"path","servers":["53fa3b59-329f-46e9-a315-468770b894ed"],"security":["a6204cec-a94b-49b7-bd5a-36f4742263c5"],"path":"/api/v1/hosts/{id}","baseUrlOptions":["https://{command_center_host}"],"title":"Update a host","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e6451d60-3f7f-449a-be14-8c1c9873f416":{"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"name","typeLabel":"string"},"public_ip":{"oneOf":[{"type":"string","uniqueKey":"public_ip.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"public_ip.oneOf.1","typeLabel":"null"}],"uniqueKey":"public_ip","typeLabel":"string | null"},"private_ip":{"oneOf":[{"type":"string","uniqueKey":"private_ip.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"private_ip.oneOf.1","typeLabel":"null"}],"uniqueKey":"private_ip","typeLabel":"string | null"},"ip_connect_mode":{"type":"string","enum":["auto","public","private"],"uniqueKey":"ip_connect_mode","typeLabel":"enum\u003cstring>"},"additional_names":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255,"uniqueKey":"additional_names.items.[INDEX]","typeLabel":"string"},"uniqueKey":"additional_names","typeLabel":"string[]"},"target_type":{"type":"string","enum":["ssh","winrm"],"uniqueKey":"target_type","typeLabel":"enum\u003cstring>"},"target_port":{"oneOf":[{"type":"integer","minimum":1,"maximum":65535,"uniqueKey":"target_port.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":1,"maximum":65535,"uniqueKey":"target_port.oneOf.1","typeLabel":"null"}],"uniqueKey":"target_port","typeLabel":"integer | null"},"skip_tls_verify":{"type":"boolean","uniqueKey":"skip_tls_verify","typeLabel":"boolean"},"knowledge":{"oneOf":[{"type":"string","uniqueKey":"knowledge.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"knowledge.oneOf.1","typeLabel":"null"}],"uniqueKey":"knowledge","typeLabel":"string | null"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"tags","typeLabel":"string[]"},"satellite_cluster_id":{"oneOf":[{"type":"string","uniqueKey":"satellite_cluster_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"satellite_cluster_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"satellite_cluster_id","typeLabel":"string | null"},"placement":{"oneOf":[{"type":"object","properties":{"namespace":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]([-a-z0-9]*[a-z0-9])?$","uniqueKey":"placement.oneOf.0.namespace","typeLabel":"string"},"node_selector":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"placement.oneOf.0.node_selector.additionalProperties","typeLabel":"string"},"uniqueKey":"placement.oneOf.0.node_selector","typeLabel":"object"},"tolerations":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1,"uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX].key","typeLabel":"string"},"value":{"type":"string","minLength":1,"uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX].value","typeLabel":"string"},"operator":{"type":"string","enum":["Exists","Equal"],"uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX].operator","typeLabel":"enum\u003cstring>"},"effect":{"type":"string","enum":["NoSchedule","PreferNoSchedule","NoExecute"],"uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX].effect","typeLabel":"enum\u003cstring>"},"tolerationSeconds":{"type":"integer","uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX].tolerationSeconds","typeLabel":"integer"}},"uniqueKey":"placement.oneOf.0.tolerations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"placement.oneOf.0.tolerations","typeLabel":"object[]"}},"additionalProperties":false,"uniqueKey":"placement.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"namespace":{"type":"string","minLength":1,"maxLength":63,"pattern":"^[a-z0-9]([-a-z0-9]*[a-z0-9])?$"},"node_selector":{"type":"object","additionalProperties":{"type":"string"}},"tolerations":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","minLength":1},"value":{"type":"string","minLength":1},"operator":{"type":"string","enum":["Exists","Equal"]},"effect":{"type":"string","enum":["NoSchedule","PreferNoSchedule","NoExecute"]},"tolerationSeconds":{"type":"integer"}}}}},"additionalProperties":false,"uniqueKey":"placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"placement","typeLabel":"object | null"},"jump_host_ids":{"type":"array","items":{"type":"string","uniqueKey":"jump_host_ids.items.[INDEX]","typeLabel":"string"},"maxItems":5,"uniqueKey":"jump_host_ids","typeLabel":"string[]"},"is_jump_host":{"type":"boolean","uniqueKey":"is_jump_host","typeLabel":"boolean"},"jump_host_username_credential_id":{"oneOf":[{"type":"string","uniqueKey":"jump_host_username_credential_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"jump_host_username_credential_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"jump_host_username_credential_id","typeLabel":"string | null"},"jump_host_secret_credential_id":{"oneOf":[{"type":"string","uniqueKey":"jump_host_secret_credential_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"jump_host_secret_credential_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"jump_host_secret_credential_id","typeLabel":"string | null"},"eligible_subnets":{"type":"array","items":{"type":"string","uniqueKey":"eligible_subnets.items.[INDEX]","typeLabel":"string"},"maxItems":64,"uniqueKey":"eligible_subnets","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"\u003cstring>","public_ip":"\u003cstring>","private_ip":"\u003cstring>","additional_names":["\u003cstring>"],"target_port":32768,"skip_tls_verify":true,"knowledge":"\u003cstring>","tags":["\u003cstring>"],"satellite_cluster_id":"\u003cstring>","placement":{"namespace":"\u003cstring>","node_selector":{},"tolerations":[{"key":"\u003cstring>","value":"\u003cstring>","tolerationSeconds":123}]},"jump_host_ids":["\u003cstring>"],"is_jump_host":true,"jump_host_username_credential_id":"\u003cstring>","jump_host_secret_credential_id":"\u003cstring>","eligible_subnets":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3ebeaf38-1529-41b9-a626-053acfb0ddc2":{"description":"The updated host","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"hst_8272f9b4-3c1e-4a2b-9f0d-1e2c3b4a5d6e","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","example":"web-01","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"org_id":{"type":"string","example":"org_460b541c-...","isRequired":true,"uniqueKey":"org_id","typeLabel":"string"},"tenant_id":{"type":"string","example":"ten_115bea44-...","isRequired":true,"uniqueKey":"tenant_id","typeLabel":"string"},"public_ip":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"public_ip.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"public_ip.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"public_ip","typeLabel":"string | null"},"private_ip":{"oneOf":[{"type":"string","example":"10.0.4.12","isRequired":true,"uniqueKey":"private_ip.oneOf.0","typeLabel":"string"},{"type":"null","example":"10.0.4.12","isRequired":true,"uniqueKey":"private_ip.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"private_ip","typeLabel":"string | null"},"ip_connect_mode":{"type":"string","enum":["auto","public","private"],"isRequired":true,"uniqueKey":"ip_connect_mode","typeLabel":"enum\u003cstring>"},"target_type":{"type":"string","enum":["ssh","winrm"],"isRequired":true,"uniqueKey":"target_type","typeLabel":"enum\u003cstring>"},"target_port":{"oneOf":[{"type":"integer","isRequired":true,"uniqueKey":"target_port.oneOf.0","typeLabel":"integer"},{"type":"null","isRequired":true,"uniqueKey":"target_port.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"target_port","typeLabel":"integer | null"},"skip_tls_verify":{"type":"boolean","isRequired":true,"uniqueKey":"skip_tls_verify","typeLabel":"boolean"},"additional_names":{"type":"array","items":{"type":"string","uniqueKey":"additional_names.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"additional_names","typeLabel":"string[]"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"example":["os:linux","type:web"],"isRequired":true,"uniqueKey":"tags","typeLabel":"string[]"},"knowledge":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"knowledge.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"knowledge.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"knowledge","typeLabel":"string | null"},"is_jump_host":{"type":"boolean","isRequired":true,"uniqueKey":"is_jump_host","typeLabel":"boolean"},"jump_host_ids":{"type":"array","items":{"type":"string","uniqueKey":"jump_host_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"jump_host_ids","typeLabel":"string[]"},"jump_host_username_credential_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"jump_host_username_credential_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"jump_host_username_credential_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"jump_host_username_credential_id","typeLabel":"string | null"},"jump_host_secret_credential_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"jump_host_secret_credential_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"jump_host_secret_credential_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"jump_host_secret_credential_id","typeLabel":"string | null"},"eligible_subnets":{"type":"array","items":{"type":"string","uniqueKey":"eligible_subnets.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"eligible_subnets","typeLabel":"string[]"},"created_at":{"type":"string","format":"date-time","example":"2026-08-26T10:00:26.380Z","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","example":"2026-08-26T10:00:26.380Z","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"unique_id":{"oneOf":[{"type":"string","uniqueKey":"unique_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"unique_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"unique_id","typeLabel":"string | null"},"external_id":{"oneOf":[{"type":"string","uniqueKey":"external_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"external_id","typeLabel":"string | null"},"mac":{"oneOf":[{"type":"string","uniqueKey":"mac.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"mac.oneOf.1","typeLabel":"null"}],"uniqueKey":"mac","typeLabel":"string | null"},"enrichment_source":{"oneOf":[{"type":"string","uniqueKey":"enrichment_source.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"enrichment_source.oneOf.1","typeLabel":"null"}],"uniqueKey":"enrichment_source","typeLabel":"string | null"}},"required":["id","name","org_id","tenant_id","public_ip","private_ip","ip_connect_mode","target_type","target_port","skip_tls_verify","additional_names","tags","knowledge","is_jump_host","jump_host_ids","jump_host_username_credential_id","jump_host_secret_credential_id","eligible_subnets","created_at","updated_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"hst_8272f9b4-3c1e-4a2b-9f0d-1e2c3b4a5d6e","name":"web-01","org_id":"org_460b541c-...","tenant_id":"ten_115bea44-...","public_ip":"\u003cstring>","private_ip":"10.0.4.12","ip_connect_mode":"auto","target_type":"ssh","target_port":123,"skip_tls_verify":true,"additional_names":["\u003cstring>"],"tags":["os:linux","type:web"],"knowledge":"\u003cstring>","is_jump_host":true,"jump_host_ids":["\u003cstring>"],"jump_host_username_credential_id":"\u003cstring>","jump_host_secret_credential_id":"\u003cstring>","eligible_subnets":["\u003cstring>"],"created_at":"2026-08-26T10:00:26.380Z","updated_at":"2026-08-26T10:00:26.380Z","unique_id":"\u003cstring>","external_id":"\u003cstring>","mac":"\u003cstring>","enrichment_source":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"8d2b22c2-332a-4895-b179-ee447fd273c1":{"description":"Bad request - a field is missing, malformed, or not allowed (VALIDATION_FAILED, BAD_REQUEST, INVALID_CURSOR)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_FAILED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Validation failed","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","example":"req_3702b7e7-...","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"field":{"type":"string","description":"Set when one input is at fault","uniqueKey":"field","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Set when several inputs are at fault","uniqueKey":"errors","typeLabel":"object[]"},"details":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"details.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.additionalProperties","typeLabel":"null"},"uniqueKey":"details","typeLabel":"object"}},"required":["code","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_FAILED","message":"Validation failed","request_id":"req_3702b7e7-...","field":"\u003cstring>","errors":[{"field":"\u003cstring>","message":"\u003cstring>"}],"details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"3ebde1f1-0709-4a0c-a4ca-0e48c51e1d95":{"description":"No credentials, or a key that is invalid, revoked, or expired (UNAUTHORIZED)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_FAILED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Validation failed","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","example":"req_3702b7e7-...","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"field":{"type":"string","description":"Set when one input is at fault","uniqueKey":"field","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Set when several inputs are at fault","uniqueKey":"errors","typeLabel":"object[]"},"details":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"details.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.additionalProperties","typeLabel":"null"},"uniqueKey":"details","typeLabel":"object"}},"required":["code","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_FAILED","message":"Validation failed","request_id":"req_3702b7e7-...","field":"\u003cstring>","errors":[{"field":"\u003cstring>","message":"\u003cstring>"}],"details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"3b873997-cd62-42f8-851a-e705a9a2ca37":{"description":"Authenticated but not allowed (FORBIDDEN, ORG_ACCESS_DENIED, STEP_UP_REFUSED, TWO_FACTOR_ENROLLMENT_REQUIRED, LICENSE_CAP_REACHED, LICENSE_EXPIRED)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_FAILED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Validation failed","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","example":"req_3702b7e7-...","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"field":{"type":"string","description":"Set when one input is at fault","uniqueKey":"field","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Set when several inputs are at fault","uniqueKey":"errors","typeLabel":"object[]"},"details":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"details.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.additionalProperties","typeLabel":"null"},"uniqueKey":"details","typeLabel":"object"}},"required":["code","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_FAILED","message":"Validation failed","request_id":"req_3702b7e7-...","field":"\u003cstring>","errors":[{"field":"\u003cstring>","message":"\u003cstring>"}],"details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"fab38898-b15c-451b-9d1d-4f541acc4978":{"description":"No such row that this caller can see (NOT_FOUND)","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_FAILED","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","example":"Validation failed","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","example":"req_3702b7e7-...","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"field":{"type":"string","description":"Set when one input is at fault","uniqueKey":"field","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"description":"Set when several inputs are at fault","uniqueKey":"errors","typeLabel":"object[]"},"details":{"type":"object","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"details.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"details.additionalProperties","typeLabel":"null"},"uniqueKey":"details","typeLabel":"object"}},"required":["code","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"VALIDATION_FAILED","message":"Validation failed","request_id":"req_3702b7e7-...","field":"\u003cstring>","errors":[{"field":"\u003cstring>","message":"\u003cstring>"}],"details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"a6204cec-a94b-49b7-bd5a-36f4742263c5":{"bearerAuth":{"type":"http","scheme":"bearer","description":"An API key minted in Command Center (Settings -> API Keys), sent as `Authorization: Bearer 2501_ak_...`. A Command Center session cookie is also accepted.","scopes":[]}}},"servers":{"53fa3b59-329f-46e9-a315-468770b894ed":{"url":"https://{command_center_host}","variables":{"command_center_host":{"default":"your-command-center-host","description":"Your Command Center host"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"An API key minted in Command Center (Settings -> API Keys), sent as `Authorization: Bearer 2501_ak_...`. A Command Center session cookie is also accepted.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"An API key minted in Command Center (Settings -> API Keys), sent as `Authorization: Bearer 2501_ak_...`. A Command Center session cookie is also accepted.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"0.14/openapi.json"},"subdomain":"2501","siteName":"2501.ai","title":"Update a host - 2501.ai","navMaps":{"firstHrefInVersion":{"0.18":{"href":"/0.18/api-reference/hosts/update-a-host","matchLevel":1},"0.17":{"href":"/0.17/api-reference/hosts/update-a-host","matchLevel":1},"0.16":{"href":"/0.16/api-reference/hosts/update-a-host","matchLevel":1},"0.15":{"href":"/0.15/api-reference/hosts/update-a-host","matchLevel":1},"0.14":{"href":"/0.14/api-reference/hosts/update-a-host","matchLevel":0},"0.13":{"href":"/0.13/api-reference/hosts/update-a-host","matchLevel":1},"0.12":{"href":"/0.12/api-reference/hosts/update-a-host","matchLevel":1},"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-09-17T08:17:23.649Z","originalFileLocation":"0.14/api-reference/hosts/update-a-host.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=\"description\" content=\"Partial update - only the fields in the body change.\">\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=\"Update a host - 2501.ai\">\u003cmeta data-mint-head property=\"og:description\" content=\"Partial update - only the fields in the body change.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"2501.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host\">\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=Hosts\u0026amp;title=Update+a+host\u0026amp;description=Partial+update+-+only+the+fields+in+the+body+change.\u0026amp;theme=f33d4ade6ddd98c4a45fdcd4\u0026amp;signature=f393f1f968dd8b313b253094405dc823368cb3b29c1e8fb6571aa47c42a9413d\">\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=\"Update a host - 2501.ai\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Partial update - only the fields in the body change.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://2501.mintlify.app/_mintlify/api/og/v2?division=Hosts\u0026amp;title=Update+a+host\u0026amp;description=Partial+update+-+only+the+fields+in+the+body+change.\u0026amp;theme=f33d4ade6ddd98c4a45fdcd4\u0026amp;signature=f393f1f968dd8b313b253094405dc823368cb3b29c1e8fb6571aa47c42a9413d\">\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.14/api-reference/hosts/update-a-host\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/0.14/api-reference/hosts/update-a-host.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.2501.ai/#organization\",\"name\":\"2501.ai\",\"url\":\"https://docs.2501.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/2501/gMl_w8qww9Zl47hO/logo/light.png?fit=max\u0026auto=format\u0026n=gMl_w8qww9Zl47hO\u0026q=85\u0026s=eeeb37b3ca386a00dde53b3e6235adce\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.2501.ai#website\",\"name\":\"2501.ai\",\"url\":\"https://docs.2501.ai\",\"publisher\":{\"@id\":\"https://docs.2501.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host#webpage\",\"url\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host\",\"name\":\"Update a host\",\"description\":\"Partial update - only the fields in the body change.\",\"dateModified\":\"2026-09-17T08:17:23.649Z\",\"isPartOf\":{\"@id\":\"https://docs.2501.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://docs.2501.ai/0.14/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Hosts\",\"item\":\"https://docs.2501.ai/0.14/api-reference/hosts/list-hosts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update a host\",\"item\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host#apireference\",\"headline\":\"Update a host\",\"name\":\"Update a host\",\"description\":\"Partial update - only the fields in the body change.\",\"url\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host\",\"mainEntityOfPage\":{\"@id\":\"https://docs.2501.ai/0.14/api-reference/hosts/update-a-host#webpage\"},\"dateModified\":\"2026-09-17T08:17:23.649Z\",\"publisher\":{\"@id\":\"https://docs.2501.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.2501.ai#website\"}}]}\u003c/script>\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","pages":[{"title":"0.18","href":"/0.18/api-reference/hosts/update-a-host"}]},{"version":"0.17","pages":[{"title":"0.17","href":"/0.17/api-reference/hosts/update-a-host"}]},{"version":"0.16","pages":[{"title":"0.16","href":"/0.16/api-reference/hosts/update-a-host"}]},{"version":"0.15","pages":[{"title":"0.15","href":"/0.15/api-reference/hosts/update-a-host"}]},{"version":"0.14","tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/0.14/getting-started/welcome"}]},{"tab":"Reference","groups":[{"group":"API","pages":[{"title":"API Overview","href":"/0.14/api/overview"},{"group":"Specialties","pages":[{"title":"List specialties","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/specialties","href":"/0.14/api-reference/specialties/list-specialties"},{"title":"Create a specialty","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/specialties","href":"/0.14/api-reference/specialties/create-a-specialty"},{"title":"Search specialties","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/specialties/search","href":"/0.14/api-reference/specialties/search-specialties"},{"title":"Get a specialty","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/specialties/{id}","href":"/0.14/api-reference/specialties/get-a-specialty"},{"title":"Update a specialty","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/specialties/{id}","href":"/0.14/api-reference/specialties/update-a-specialty"},{"title":"Delete a specialty","deprecated":null,"version":null,"openapi":"/0.14/openapi.json delete /api/v1/specialties/{id}","href":"/0.14/api-reference/specialties/delete-a-specialty"},{"title":"Count what references a specialty","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/specialties/{id}/references","href":"/0.14/api-reference/specialties/count-what-references-a-specialty"}]},{"group":"Blacklists","pages":[{"title":"List blacklisted commands","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/blacklists","href":"/0.14/api-reference/blacklists/list-blacklisted-commands"},{"title":"Create a blacklisted command","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/blacklists","href":"/0.14/api-reference/blacklists/create-a-blacklisted-command"},{"title":"Search blacklisted commands","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/blacklists/search","href":"/0.14/api-reference/blacklists/search-blacklisted-commands"},{"title":"Get a blacklisted command","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/blacklists/{id}","href":"/0.14/api-reference/blacklists/get-a-blacklisted-command"},{"title":"Update a blacklisted command","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/blacklists/{id}","href":"/0.14/api-reference/blacklists/update-a-blacklisted-command"},{"title":"Delete a blacklisted command","deprecated":null,"version":null,"openapi":"/0.14/openapi.json delete /api/v1/blacklists/{id}","href":"/0.14/api-reference/blacklists/delete-a-blacklisted-command"}]},{"group":"Gateways","pages":[{"title":"List gateways","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/gateways","href":"/0.14/api-reference/gateways/list-gateways"},{"title":"Create a gateway","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/gateways","href":"/0.14/api-reference/gateways/create-a-gateway"},{"title":"Search gateways","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/gateways/search","href":"/0.14/api-reference/gateways/search-gateways"},{"title":"Get a gateway","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/gateways/{id}","href":"/0.14/api-reference/gateways/get-a-gateway"},{"title":"Update a gateway","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/gateways/{id}","href":"/0.14/api-reference/gateways/update-a-gateway"},{"title":"Delete a gateway","deprecated":null,"version":null,"openapi":"/0.14/openapi.json delete /api/v1/gateways/{id}","href":"/0.14/api-reference/gateways/delete-a-gateway"},{"title":"Count what references a gateway","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/gateways/{id}/references","href":"/0.14/api-reference/gateways/count-what-references-a-gateway"}]},{"group":"Hosts","pages":[{"title":"List hosts","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/hosts","href":"/0.14/api-reference/hosts/list-hosts"},{"title":"Create a host","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/hosts","href":"/0.14/api-reference/hosts/create-a-host"},{"title":"Search hosts","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/hosts/search","href":"/0.14/api-reference/hosts/search-hosts"},{"title":"Bulk import hosts","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/hosts/batch","href":"/0.14/api-reference/hosts/bulk-import-hosts"},{"title":"Bulk export hosts","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/hosts/export","href":"/0.14/api-reference/hosts/bulk-export-hosts"},{"title":"Get a host","description":"Adds an `agents` array of the host usable agents.","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/hosts/{id}","href":"/0.14/api-reference/hosts/get-a-host"},{"title":"Update a host","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/hosts/{id}","href":"/0.14/api-reference/hosts/update-a-host"},{"title":"Delete a host","description":"Archives the host agents and their tasks, then deletes the host, in one transaction.","deprecated":null,"version":null,"openapi":"/0.14/openapi.json delete /api/v1/hosts/{id}","href":"/0.14/api-reference/hosts/delete-a-host"},{"title":"List a host agents","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/hosts/{id}/agents","href":"/0.14/api-reference/hosts/list-a-host-agents"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents","href":"/0.14/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents","href":"/0.14/api-reference/agents/create-an-agent"},{"title":"Search agents","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents/search","href":"/0.14/api-reference/agents/search-agents"},{"title":"Bulk import agents","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/batch","href":"/0.14/api-reference/agents/bulk-import-agents"},{"title":"Bulk export agents","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents/export","href":"/0.14/api-reference/agents/bulk-export-agents"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents/{id}","href":"/0.14/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/{id}","href":"/0.14/api-reference/agents/update-an-agent"},{"title":"Archive an agent","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/{id}/archive","href":"/0.14/api-reference/agents/archive-an-agent"},{"title":"Archive idle tasks","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/{id}/archive-tasks","href":"/0.14/api-reference/agents/archive-idle-tasks"},{"title":"List an agent tasks","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents/{id}/tasks","href":"/0.14/api-reference/agents/list-an-agent-tasks"},{"title":"Test the connection","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/{id}/test-connection","href":"/0.14/api-reference/agents/test-the-connection"},{"title":"List an agent plugins","deprecated":null,"version":null,"openapi":"/0.14/openapi.json get /api/v1/agents/{id}/plugins","href":"/0.14/api-reference/agents/list-an-agent-plugins"},{"title":"Attach a plugin","deprecated":null,"version":null,"openapi":"/0.14/openapi.json post /api/v1/agents/{id}/plugins","href":"/0.14/api-reference/agents/attach-a-plugin"},{"title":"Detach a plugin","deprecated":null,"version":null,"openapi":"/0.14/openapi.json delete /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.14/api-reference/agents/detach-a-plugin"}]}]},{"group":"CLI","pages":[{"title":"2501 CLI","href":"/0.14/cli/overview"},{"title":"login \u0026 status","href":"/0.14/cli/login-status"},{"title":"resources","href":"/0.14/cli/resources"},{"title":"infra","href":"/0.14/cli/infra"},{"title":"runner","href":"/0.14/cli/runner"},{"title":"chat","href":"/0.14/cli/chat"}]},{"group":"Deploy","pages":[{"title":"Overview","href":"/0.14/deployment/overview"},{"title":"Init Command","href":"/0.14/deployment/init-command"},{"title":"Configuration","href":"/0.14/deployment/configuration"},{"title":"Docker Swarm","href":"/0.14/deployment/docker-swarm"},{"title":"Kubernetes","href":"/0.14/deployment/kubernetes"},{"title":"LLM Providers","href":"/0.14/deployment/llm-providers"},{"title":"Users \u0026 Organizations","href":"/0.14/deployment/users-organizations"},{"title":"Troubleshooting","href":"/0.14/deployment/troubleshooting"},{"title":"Feature Toggles","href":"/0.14/deployment/feature-toggles"}]},{"group":"Configure","pages":[{"group":"Agent Behavior","pages":[{"title":"Specialties","href":"/0.14/configure/specialties"},{"title":"Operational Rules","href":"/0.14/configure/operational-rules"},{"title":"Blacklist","href":"/0.14/configure/blacklist"}]},{"title":"Clusters","href":"/0.14/configure/clusters"},{"title":"Knowledge Base","href":"/0.14/configure/knowledge"},{"title":"Import and Export","href":"/0.14/configure/import-export"},{"group":"Access \u0026 Secrets","pages":[{"title":"Credentials","href":"/0.14/configure/credentials"},{"title":"API Keys","href":"/0.14/configure/api-keys"},{"title":"Plugins","href":"/0.14/configure/plugins"}]},{"group":"Integration","pages":[{"title":"Webhooks","href":"/0.14/configure/webhooks"},{"title":"Configuration as Code","href":"/0.14/configure/configuration-as-code"},{"group":"Resource Reference","pages":[{"title":"Agent","href":"/0.14/configure/resources/agents"},{"title":"Host","href":"/0.14/configure/resources/hosts"},{"title":"Specialty","href":"/0.14/configure/resources/specialties"},{"title":"Operational Rule","href":"/0.14/configure/resources/operational-rules"},{"title":"Credential","href":"/0.14/configure/resources/credentials"},{"title":"Gateway","href":"/0.14/configure/resources/gateways"},{"title":"Blacklist","href":"/0.14/configure/resources/blacklist"}]},{"title":"Network Discovery","href":"/0.14/configure/discovery"}]},{"group":"LLM","pages":[{"title":"Providers","href":"/0.14/configure/providers"},{"title":"Models","href":"/0.14/configure/models"}]},{"title":"Users","href":"/0.14/configure/users"},{"title":"Licensing \u0026 Usage","href":"/0.14/configure/licensing"}]}]},{"tab":"Benchmark","pages":[{"title":"Benchmark","href":"/0.14/benchmark/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/0.14/configure/prompting"}]}]},{"version":"0.13","pages":[{"title":"0.13","href":"/0.13/api-reference/hosts/update-a-host"}]},{"version":"0.12","pages":[{"title":"0.12","href":"/0.12/api-reference/hosts/update-a-host"}]},{"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":"Update a host - 2501.ai","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}