Removes the agent’s own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.
An API key minted in Command Center (Settings -> API Keys), sent as Authorization: Bearer 2501_ak_.... A Command Center session cookie is also accepted.
Effective direct and specialty-inherited MCP assignments, present on list and search responses
Required range: x >= 0
{"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":"6ae99559e644b2af9be4bb4b","collectionId":"a64b271a-a494-467a-96af-8f22a7bf9363","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae99559e644b2af9be4bb4b"},"entitlements":{},"buildId":"6aeafdf5057e717ec7e8ed2a","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Reference","count":966},{"language":"default","tag":"API","count":498},{"language":"default","tag":"Configure","count":303},{"language":"default","tag":"Guides","count":195},{"language":"default","tag":"Docs","count":189},{"language":"default","tag":"Benchmark","count":175},{"language":"default","tag":"Deploy","count":125},{"language":"default","tag":"Agents","count":121},{"language":"default","tag":"Integration","count":119},{"language":"default","tag":"Concepts","count":111}]},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"0.17/api-reference/agents/detach-a-plugin","slug":"/0.17/api-reference/agents/detach-a-plugin","pageMetadata":{"title":"Detach a plugin","description":"Removes the agent's own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.17/api-reference/agents/detach-a-plugin","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: \"Removes the agent’s own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\"\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":"Detach a plugin","description":"Removes the agent's own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.17/api-reference/agents/detach-a-plugin","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Agents"],"summary":"Detach a plugin","description":"Removes the agent's own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.","parameters":["c65303c5-e32d-4201-bd1f-3fdde823a0fa","32527911-63a4-4b74-906a-1f0090a02b94"],"responses":{"200":"839a239a-97ea-42bc-9b6e-319ff4dc32ab","401":"093331e4-8242-44d5-817d-8898d033ac28","403":"d11f1c42-c16e-44cd-951d-a8b1475c897a","404":"a4923f6a-1cd4-44e0-8bb4-fe88e3e622ee","409":"33d307a8-a287-4111-bce3-2265f479e013"},"method":"delete","type":"path","servers":["31d1a0a9-094d-4cde-99bb-c97eac1ddb12"],"security":["1ca2abe6-39cf-498c-9372-73a9cdf0e486"],"path":"/api/v1/agents/{id}/plugins/{pluginId}","baseUrlOptions":["https://{command_center_host}"],"title":"Detach a plugin","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"c65303c5-e32d-4201-bd1f-3fdde823a0fa":{"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"},"32527911-63a4-4b74-906a-1f0090a02b94":{"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"pluginId","in":"path"}},"responses":{"839a239a-97ea-42bc-9b6e-319ff4dc32ab":{"description":"The agent","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","example":"agt_a9bf5a2b-...","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"name":{"type":"string","example":"linux-ops - web-01","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"status":{"type":"string","enum":["idle","running","error","archived"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"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"},"host_id":{"oneOf":[{"type":"string","example":"hst_8272f9b4-...","isRequired":true,"uniqueKey":"host_id.oneOf.0","typeLabel":"string"},{"type":"null","example":"hst_8272f9b4-...","isRequired":true,"uniqueKey":"host_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"host_id","typeLabel":"string | null"},"specialty_id":{"type":"string","example":"spc_9e274f8c-...","isRequired":true,"uniqueKey":"specialty_id","typeLabel":"string"},"main_engine":{"type":"string","example":"qwen3-coder-480b","isRequired":true,"uniqueKey":"main_engine","typeLabel":"string"},"secondary_engine":{"type":"string","example":"qwen3-coder-30b","isRequired":true,"uniqueKey":"secondary_engine","typeLabel":"string"},"remote_execution":{"type":"boolean","isRequired":true,"uniqueKey":"remote_execution","typeLabel":"boolean"},"credential_config":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"credential_id":{"type":"string","example":"crd_1f3c8a90-...","isRequired":true,"uniqueKey":"credential_config.oneOf.0.items.[INDEX].credential_id","typeLabel":"string"},"credential_role":{"type":"string","enum":["ssh_username","ssh_password","ssh_private_key","ssh_public_key"],"isRequired":true,"uniqueKey":"credential_config.oneOf.0.items.[INDEX].credential_role","typeLabel":"enum\u003cstring>"},"order":{"type":"integer","isRequired":true,"uniqueKey":"credential_config.oneOf.0.items.[INDEX].order","typeLabel":"integer"},"is_required":{"type":"boolean","isRequired":true,"uniqueKey":"credential_config.oneOf.0.items.[INDEX].is_required","typeLabel":"boolean"}},"required":["credential_id","credential_role","order","is_required"],"uniqueKey":"credential_config.oneOf.0.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"credential_config.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"credential_id":{"type":"string","example":"crd_1f3c8a90-..."},"credential_role":{"type":"string","enum":["ssh_username","ssh_password","ssh_private_key","ssh_public_key"]},"order":{"type":"integer"},"is_required":{"type":"boolean"}},"required":["credential_id","credential_role","order","is_required"]},"isRequired":true,"uniqueKey":"credential_config.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"credential_config","typeLabel":"object[] | null"},"disabled_rule_ids":{"type":"array","items":{"type":"string","uniqueKey":"disabled_rule_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"disabled_rule_ids","typeLabel":"string[]"},"accessible_credential_ids":{"type":"array","items":{"type":"string","uniqueKey":"accessible_credential_ids.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"accessible_credential_ids","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>"},"plugin_count":{"type":"integer","minimum":0,"description":"Effective direct and specialty-inherited MCP assignments, present on list and search responses","uniqueKey":"plugin_count","typeLabel":"integer"}},"required":["id","name","status","org_id","tenant_id","host_id","specialty_id","main_engine","secondary_engine","remote_execution","credential_config","disabled_rule_ids","accessible_credential_ids","created_at","updated_at"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"agt_a9bf5a2b-...","name":"linux-ops - web-01","status":"idle","org_id":"org_460b541c-...","tenant_id":"ten_115bea44-...","host_id":"hst_8272f9b4-...","specialty_id":"spc_9e274f8c-...","main_engine":"qwen3-coder-480b","secondary_engine":"qwen3-coder-30b","remote_execution":true,"credential_config":[{"credential_id":"crd_1f3c8a90-...","credential_role":"ssh_username","order":123,"is_required":true}],"disabled_rule_ids":["\u003cstring>"],"accessible_credential_ids":["\u003cstring>"],"created_at":"2026-08-26T10:00:26.380Z","updated_at":"2026-08-26T10:00:26.380Z","plugin_count":1}}},"exampleType":"generated"}},"exampleType":"generated"},"093331e4-8242-44d5-817d-8898d033ac28":{"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"},"d11f1c42-c16e-44cd-951d-a8b1475c897a":{"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"},"a4923f6a-1cd4-44e0-8bb4-fe88e3e622ee":{"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"},"33d307a8-a287-4111-bce3-2265f479e013":{"description":"The write conflicts with existing data (CONFLICT, DUPLICATE_KEY, FOREIGN_KEY_VIOLATION, RESOURCE_IN_USE)","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":{"1ca2abe6-39cf-498c-9372-73a9cdf0e486":{"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":[],"schemeName":"bearerAuth"}}},"servers":{"31d1a0a9-094d-4cde-99bb-c97eac1ddb12":{"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":[],"schemeName":"bearerAuth"},"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.17/openapi.json"},"subdomain":"2501","siteName":"2501.ai","title":"Detach a plugin - 2501.ai","navMaps":{"firstHrefInVersion":{"0.19":{"href":"/0.19/api-reference/agents/detach-a-plugin","matchLevel":1},"0.18":{"href":"/0.18/api-reference/agents/detach-a-plugin","matchLevel":1},"0.17":{"href":"/0.17/api-reference/agents/detach-a-plugin","matchLevel":0},"0.16":{"href":"/0.16/api-reference/agents/detach-a-plugin","matchLevel":1},"0.15":{"href":"/0.15/api-reference/agents/detach-a-plugin","matchLevel":1},"0.14":{"href":"/0.14/api-reference/agents/detach-a-plugin","matchLevel":1},"0.13":{"href":"/0.13/api-reference/agents/detach-a-plugin","matchLevel":1},"0.12":{"href":"/0.12/api-reference/agents/detach-a-plugin","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-10-15T12:43:13.383Z","originalFileLocation":"0.17/api-reference/agents/detach-a-plugin.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=\"Removes the agent\u0026#x27;s own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\">\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=\"Detach a plugin - 2501.ai\">\u003cmeta data-mint-head property=\"og:description\" content=\"Removes the agent\u0026#x27;s own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"2501.ai\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin\">\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=Agents\u0026amp;title=Detach+a+plugin\u0026amp;description=Removes+the+agent%27s+own+assignment+and+returns+the+agent%2C+not+the+plugin+list.+A+plugin+the+agent+only+inherits+from+its+specialty+returns+409+and+stays%3B+detail\u0026amp;theme=f33d4ade6ddd98c4a45fdcd4\u0026amp;signature=76f8c7bb1b2f23d4f20203f36c2742545a1a1b9ac818d9002b8a042362c6af30\">\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=\"Detach a plugin - 2501.ai\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Removes the agent\u0026#x27;s own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://2501.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Detach+a+plugin\u0026amp;description=Removes+the+agent%27s+own+assignment+and+returns+the+agent%2C+not+the+plugin+list.+A+plugin+the+agent+only+inherits+from+its+specialty+returns+409+and+stays%3B+detail\u0026amp;theme=f33d4ade6ddd98c4a45fdcd4\u0026amp;signature=76f8c7bb1b2f23d4f20203f36c2742545a1a1b9ac818d9002b8a042362c6af30\">\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.17/api-reference/agents/detach-a-plugin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/0.17/api-reference/agents/detach-a-plugin.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.17/api-reference/agents/detach-a-plugin#webpage\",\"url\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin\",\"name\":\"Detach a plugin\",\"description\":\"Removes the agent's own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\",\"dateModified\":\"2026-10-15T12:43:13.383Z\",\"isPartOf\":{\"@id\":\"https://docs.2501.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API\",\"item\":\"https://docs.2501.ai/0.17/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.2501.ai/0.17/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Detach a plugin\",\"item\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin#apireference\",\"headline\":\"Detach a plugin\",\"name\":\"Detach a plugin\",\"description\":\"Removes the agent's own assignment and returns the agent, not the plugin list. A plugin the agent only inherits from its specialty returns 409 and stays; details.specialty_id names the specialty to remove it from. A plugin the agent also inherits stays. A plugin the agent does not hold, unknown or hidden from the caller included, answers 200 with the agent and changes nothing.\",\"url\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin\",\"mainEntityOfPage\":{\"@id\":\"https://docs.2501.ai/0.17/api-reference/agents/detach-a-plugin#webpage\"},\"dateModified\":\"2026-10-15T12:43:13.383Z\",\"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.19","pages":[{"title":"0.19","href":"/0.19/api-reference/agents/detach-a-plugin"}]},{"version":"0.18","pages":[{"title":"0.18","href":"/0.18/api-reference/agents/detach-a-plugin"}]},{"version":"0.17","tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":"/0.17/getting-started/welcome"}]},{"tab":"Reference","groups":[{"group":"API","pages":[{"title":"API Overview","href":"/0.17/api/overview"},{"group":"Plugins","pages":[{"title":"List plugins","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins","href":"/0.17/api-reference/plugins/list-plugins"},{"title":"Create a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/plugins","href":"/0.17/api-reference/plugins/create-a-plugin"},{"title":"Search plugins","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins/search","href":"/0.17/api-reference/plugins/search-plugins"},{"title":"Get a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins/{id}","href":"/0.17/api-reference/plugins/get-a-plugin"},{"title":"Update a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/plugins/{id}","href":"/0.17/api-reference/plugins/update-a-plugin"},{"title":"Delete a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/plugins/{id}","href":"/0.17/api-reference/plugins/delete-a-plugin"},{"title":"List the specialties that inherit a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins/{id}/specialties","href":"/0.17/api-reference/plugins/list-the-specialties-that-inherit-a-plugin"},{"title":"Assign a plugin to a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/plugins/{id}/specialties/{specialtyId}","href":"/0.17/api-reference/plugins/assign-a-plugin-to-a-specialty"},{"title":"Stop a specialty inheriting a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/plugins/{id}/specialties/{specialtyId}","href":"/0.17/api-reference/plugins/stop-a-specialty-inheriting-a-plugin"},{"title":"List the agents that have a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins/{id}/agents","href":"/0.17/api-reference/plugins/list-the-agents-that-have-a-plugin"},{"title":"Assign a plugin to an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/plugins/{id}/agents/{agentId}","href":"/0.17/api-reference/plugins/assign-a-plugin-to-an-agent"},{"title":"Remove a plugin from an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/plugins/{id}/agents/{agentId}","href":"/0.17/api-reference/plugins/remove-a-plugin-from-an-agent"},{"title":"Read the OAuth account status of a plugin for an organization","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/plugins/{id}/oauth","href":"/0.17/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.17/openapi.json delete /api/v1/plugins/{id}/oauth/trusted-issuer","href":"/0.17/api-reference/plugins/forget-the-authorization-server-a-plugin-trusts"}]},{"group":"Specialties","pages":[{"title":"List specialties","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/specialties","href":"/0.17/api-reference/specialties/list-specialties"},{"title":"Create a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/specialties","href":"/0.17/api-reference/specialties/create-a-specialty"},{"title":"Search specialties","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/specialties/search","href":"/0.17/api-reference/specialties/search-specialties"},{"title":"Get a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/specialties/{id}","href":"/0.17/api-reference/specialties/get-a-specialty"},{"title":"Update a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/specialties/{id}","href":"/0.17/api-reference/specialties/update-a-specialty"},{"title":"Delete a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/specialties/{id}","href":"/0.17/api-reference/specialties/delete-a-specialty"},{"title":"Count what references a specialty","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/specialties/{id}/references","href":"/0.17/api-reference/specialties/count-what-references-a-specialty"}]},{"group":"Blacklists","pages":[{"title":"List blacklisted commands","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/blacklists","href":"/0.17/api-reference/blacklists/list-blacklisted-commands"},{"title":"Create a blacklisted command","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/blacklists","href":"/0.17/api-reference/blacklists/create-a-blacklisted-command"},{"title":"Search blacklisted commands","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/blacklists/search","href":"/0.17/api-reference/blacklists/search-blacklisted-commands"},{"title":"Get a blacklisted command","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/blacklists/{id}","href":"/0.17/api-reference/blacklists/get-a-blacklisted-command"},{"title":"Update a blacklisted command","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/blacklists/{id}","href":"/0.17/api-reference/blacklists/update-a-blacklisted-command"},{"title":"Delete a blacklisted command","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/blacklists/{id}","href":"/0.17/api-reference/blacklists/delete-a-blacklisted-command"}]},{"group":"Gateways","pages":[{"title":"List gateways","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/gateways","href":"/0.17/api-reference/gateways/list-gateways"},{"title":"Create a gateway","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/gateways","href":"/0.17/api-reference/gateways/create-a-gateway"},{"title":"Search gateways","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/gateways/search","href":"/0.17/api-reference/gateways/search-gateways"},{"title":"Get a gateway","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/gateways/{id}","href":"/0.17/api-reference/gateways/get-a-gateway"},{"title":"Update a gateway","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/gateways/{id}","href":"/0.17/api-reference/gateways/update-a-gateway"},{"title":"Delete a gateway","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/gateways/{id}","href":"/0.17/api-reference/gateways/delete-a-gateway"},{"title":"Count what references a gateway","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/gateways/{id}/references","href":"/0.17/api-reference/gateways/count-what-references-a-gateway"}]},{"group":"Hosts","pages":[{"title":"List hosts","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/hosts","href":"/0.17/api-reference/hosts/list-hosts"},{"title":"Create a host","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/hosts","href":"/0.17/api-reference/hosts/create-a-host"},{"title":"Search hosts","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/hosts/search","href":"/0.17/api-reference/hosts/search-hosts"},{"title":"Bulk import hosts","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/hosts/batch","href":"/0.17/api-reference/hosts/bulk-import-hosts"},{"title":"Bulk export hosts","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/hosts/export","href":"/0.17/api-reference/hosts/bulk-export-hosts"},{"title":"Get a host","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/hosts/{id}","href":"/0.17/api-reference/hosts/get-a-host"},{"title":"Update a host","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/hosts/{id}","href":"/0.17/api-reference/hosts/update-a-host"},{"title":"Delete a host","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/hosts/{id}","href":"/0.17/api-reference/hosts/delete-a-host"},{"title":"List a host agents","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/hosts/{id}/agents","href":"/0.17/api-reference/hosts/list-a-host-agents"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents","href":"/0.17/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents","href":"/0.17/api-reference/agents/create-an-agent"},{"title":"Search agents","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/search","href":"/0.17/api-reference/agents/search-agents"},{"title":"Bulk import agents","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/batch","href":"/0.17/api-reference/agents/bulk-import-agents"},{"title":"Bulk export agents","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/export","href":"/0.17/api-reference/agents/bulk-export-agents"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/{id}","href":"/0.17/api-reference/agents/get-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}","href":"/0.17/api-reference/agents/update-an-agent"},{"title":"Archive an agent","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/archive","href":"/0.17/api-reference/agents/archive-an-agent"},{"title":"Archive idle tasks","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/archive-tasks","href":"/0.17/api-reference/agents/archive-idle-tasks"},{"title":"List an agent tasks","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/{id}/tasks","href":"/0.17/api-reference/agents/list-an-agent-tasks"},{"title":"Test the connection","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/test-connection","href":"/0.17/api-reference/agents/test-the-connection"},{"title":"List an agent plugins","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/{id}/plugins","href":"/0.17/api-reference/agents/list-an-agent-plugins"},{"title":"Save a plugin assignment","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/plugins","href":"/0.17/api-reference/agents/save-a-plugin-assignment"},{"title":"Replace an agent's plugin assignments","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/replace-plugins","href":"/0.17/api-reference/agents/replace-an-agents-plugin-assignments"},{"title":"Read one plugin assignment","description":"The same entry as in the agent's plugin list, disabled assignments included: the plugin and assignment_source, never secrets. A plugin the agent only inherits from its specialty answers 404 unless include_inherited=true. Requires read access to the agent and plugin.","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.17/api-reference/agents/read-one-plugin-assignment"},{"title":"Detach a plugin","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/agents/{id}/plugins/{pluginId}","href":"/0.17/api-reference/agents/detach-a-plugin"},{"title":"Check an assigned MCP connection","description":"The engine initializes the saved endpoint with anonymous access, the Bearer/API-key credential the plugin sends or its valid OAuth authorization, lists tools without calling them, then closes the client. The credential and its resolved value are checked again before success. Disabled assignments may be checked without enabling them, except a hosted MCP server: the check starts it, so only a tenant-level administrator may check one that is turned off, and anyone else gets 403. A failed check returns 200 with safe failure categories; an unavailable engine returns ENGINE_ERROR.","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/agents/{id}/plugins/{pluginId}/check","href":"/0.17/api-reference/agents/check-an-assigned-mcp-connection"}]},{"group":"Credentials","pages":[{"title":"List credentials","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/credentials","href":"/0.17/api-reference/credentials/list-credentials"},{"title":"Create a credential","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/credentials","href":"/0.17/api-reference/credentials/create-a-credential"},{"title":"Search credentials","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/credentials/search","href":"/0.17/api-reference/credentials/search-credentials"},{"title":"Get a credential","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/credentials/{id}","href":"/0.17/api-reference/credentials/get-a-credential"},{"title":"Update a credential","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/credentials/{id}","href":"/0.17/api-reference/credentials/update-a-credential"},{"title":"Delete a credential","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/credentials/{id}","href":"/0.17/api-reference/credentials/delete-a-credential"},{"title":"Get credential usage","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/credentials/{id}/references","href":"/0.17/api-reference/credentials/get-credential-usage"}]},{"group":"Operational Rules","pages":[{"title":"List operational rules","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/operational-rules","href":"/0.17/api-reference/operational-rules/list-operational-rules"},{"title":"Create an operational rule","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/operational-rules","href":"/0.17/api-reference/operational-rules/create-an-operational-rule"},{"title":"Search operational rules","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/operational-rules/search","href":"/0.17/api-reference/operational-rules/search-operational-rules"},{"title":"Get an operational rule","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/operational-rules/{id}","href":"/0.17/api-reference/operational-rules/get-an-operational-rule"},{"title":"Update an operational rule","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/operational-rules/{id}","href":"/0.17/api-reference/operational-rules/update-an-operational-rule"},{"title":"Delete an operational rule","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/operational-rules/{id}","href":"/0.17/api-reference/operational-rules/delete-an-operational-rule"}]},{"group":"Scenarios","pages":[{"title":"List scenarios","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/scenarios","href":"/0.17/api-reference/scenarios/list-scenarios"},{"title":"Create a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/scenarios","href":"/0.17/api-reference/scenarios/create-a-scenario"},{"title":"Get a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/scenarios/{id}","href":"/0.17/api-reference/scenarios/get-a-scenario"},{"title":"Update a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/scenarios/{id}","href":"/0.17/api-reference/scenarios/update-a-scenario"},{"title":"Delete a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/scenarios/{id}","href":"/0.17/api-reference/scenarios/delete-a-scenario"},{"title":"Run a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/scenarios/{id}/run","href":"/0.17/api-reference/scenarios/run-a-scenario"},{"title":"List runs of a scenario","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/scenarios/{id}/runs","href":"/0.17/api-reference/scenarios/list-runs-of-a-scenario"},{"title":"Get a run","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/scenarios/{id}/runs/{reportId}","href":"/0.17/api-reference/scenarios/get-a-run"},{"title":"Stop a run","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/scenarios/{id}/runs/{reportId}/stop","href":"/0.17/api-reference/scenarios/stop-a-run"}]},{"group":"Benchmarks","pages":[{"title":"List benchmarks","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/benchmarks","href":"/0.17/api-reference/benchmarks/list-benchmarks"},{"title":"Run a benchmark","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/benchmarks","href":"/0.17/api-reference/benchmarks/run-a-benchmark"},{"title":"Get a benchmark","deprecated":null,"version":null,"openapi":"/0.17/openapi.json get /api/v1/benchmarks/{id}","href":"/0.17/api-reference/benchmarks/get-a-benchmark"},{"title":"Delete a benchmark","deprecated":null,"version":null,"openapi":"/0.17/openapi.json delete /api/v1/benchmarks/{id}","href":"/0.17/api-reference/benchmarks/delete-a-benchmark"},{"title":"Cancel a benchmark","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/benchmarks/{id}/cancel","href":"/0.17/api-reference/benchmarks/cancel-a-benchmark"}]},{"group":"Signals","pages":[{"title":"Receive a Splunk alert","deprecated":null,"version":null,"openapi":"/0.17/openapi.json post /api/v1/signals","href":"/0.17/api-reference/signals/receive-a-splunk-alert"}]}]},{"group":"CLI","pages":[{"title":"2501 CLI","href":"/0.17/cli/overview"},{"title":"login \u0026 status","href":"/0.17/cli/login-status"},{"title":"resources","href":"/0.17/cli/resources"},{"title":"infra","href":"/0.17/cli/infra"},{"title":"chat","href":"/0.17/cli/chat"}]},{"group":"Deploy","pages":[{"title":"Overview","href":"/0.17/deployment/overview"},{"title":"Init Command","href":"/0.17/deployment/init-command"},{"title":"Configuration","href":"/0.17/deployment/configuration"},{"title":"Docker Swarm","href":"/0.17/deployment/docker-swarm"},{"title":"Kubernetes","href":"/0.17/deployment/kubernetes"},{"title":"LLM Providers","href":"/0.17/deployment/llm-providers"},{"title":"Users \u0026 Organizations","href":"/0.17/deployment/users-organizations"},{"title":"Troubleshooting","href":"/0.17/deployment/troubleshooting"},{"title":"Feature Toggles","href":"/0.17/deployment/feature-toggles"},{"title":"Verify Image Signatures","href":"/0.17/deployment/verify-downloads"}]},{"group":"Configure","pages":[{"group":"Agent Behavior","pages":[{"title":"Specialties","href":"/0.17/configure/specialties"},{"title":"Operational Rules","href":"/0.17/configure/operational-rules"},{"title":"Blacklist","href":"/0.17/configure/blacklist"}]},{"title":"Clusters","href":"/0.17/configure/clusters"},{"title":"Knowledge Base","href":"/0.17/configure/knowledge"},{"title":"Import and Export","href":"/0.17/configure/import-export"},{"group":"Access \u0026 Secrets","pages":[{"title":"Credentials","href":"/0.17/configure/credentials"},{"title":"API Keys","href":"/0.17/configure/api-keys"},{"title":"Plugins","href":"/0.17/configure/plugins"}]},{"group":"Integration","pages":[{"title":"Webhooks","href":"/0.17/configure/webhooks"},{"title":"Configuration as Code","href":"/0.17/configure/configuration-as-code"},{"group":"Resource Reference","pages":[{"title":"Agent","href":"/0.17/configure/resources/agents"},{"title":"Host","href":"/0.17/configure/resources/hosts"},{"title":"Specialty","href":"/0.17/configure/resources/specialties"},{"title":"Operational Rule","href":"/0.17/configure/resources/operational-rules"},{"title":"Credential","href":"/0.17/configure/resources/credentials"},{"title":"Gateway","href":"/0.17/configure/resources/gateways"},{"title":"Blacklist","href":"/0.17/configure/resources/blacklist"}]},{"title":"Network Discovery","href":"/0.17/configure/discovery"}]},{"group":"LLM","pages":[{"title":"Providers","href":"/0.17/configure/providers"},{"title":"Models","href":"/0.17/configure/models"}]},{"title":"Users","href":"/0.17/configure/users"},{"title":"Licensing \u0026 Usage","href":"/0.17/configure/licensing"}]}]},{"tab":"Benchmark","pages":[{"title":"Benchmark","href":"/0.17/benchmark/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/0.17/configure/prompting"}]}]},{"version":"0.16","pages":[{"title":"0.16","href":"/0.16/api-reference/agents/detach-a-plugin"}]},{"version":"0.15","pages":[{"title":"0.15","href":"/0.15/api-reference/agents/detach-a-plugin"}]},{"version":"0.14","pages":[{"title":"0.14","href":"/0.14/api-reference/agents/detach-a-plugin"}]},{"version":"0.13","pages":[{"title":"0.13","href":"/0.13/api-reference/agents/detach-a-plugin"}]},{"version":"0.12","pages":[{"title":"0.12","href":"/0.12/api-reference/agents/detach-a-plugin"}]},{"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"}]}]},"basePath":"","title":"Detach a plugin - 2501.ai","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}