The Mutagent client (and its async twin AsyncMutagent) takes options controlling auth, the API
endpoint, and timeouts. With no options it reads MUTAGENT_API_KEY from the environment and targets
the hosted Platform.
from mutagent import Mutagentclient = Mutagent( api_key="<key>", # defaults to the MUTAGENT_API_KEY env var server_url="https://api.mutagent.io", # optional endpoint override timeout=30.0, # seconds)
Option
Description
api_key
Credential. Defaults to the MUTAGENT_API_KEY env var.
server_url
API endpoint. Defaults to the MUTAGENT_SERVER_URL env var, then the hosted Platform.
timeout
Per-request timeout in seconds. Default: 60.
Async
from mutagent import AsyncMutagentasync with AsyncMutagent() as client: ...
Which workspace a call acts in
A workspace API key acts in its own workspace. With an organization API key, send the workspace as
the x-workspace-id header. Set it on an httpx.Client and pass that as http_client:
import httpxfrom mutagent import Mutagentclient = Mutagent(http_client=httpx.Client(headers={"x-workspace-id": "<workspace-id>"}))print([config.name for config in client.llm_providers.list_provider_configs().configs])
client.workspaces.list_workspaces() returns the IDs as workspaces[].id_. See
API keys for the two kinds of key.
Mutagent() with MUTAGENT_API_KEY exported is enough for most scripts. Override server_url
only for a non-default endpoint.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Mutagent Docs","description":"Documentation for Mutagent: the Software Factory, Helix, the CLI, the SDK and integrations for building and improving AI agents.","colors":{"primary":"#7E47D7","light":"#A78BFA","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/light-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=f11adc25a4173de6c845ef141777fe48","dark":"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/dark-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=08f852d5d91158e5ea4cba3f6fc12835"},"favicon":"https://mintcdn.com/architech/djP5ca9gPRM0LwAG/favicon-tile.svg?fit=max\u0026auto=format\u0026n=djP5ca9gPRM0LwAG\u0026q=85\u0026s=96d906a3ed948ae1dcc6b700cbc71f96","background":{"color":{"light":"#FFFFFF","dark":"#050208"}},"fonts":{"heading":{"family":"Space Grotesk","weight":600},"body":{"family":"Space Grotesk","weight":400}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"architech","hasAudioNarration":false,"actualSubdomain":"architech","customDomains":["docs.mutagent.io"],"gitSource":{"type":"github","owner":"architech-printworks","repo":"mutagent-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b005c79a671b9155321fa53","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Helix","count":45},{"language":"default","tag":"Factory","count":28},{"language":"default","tag":"CLI","count":26},{"language":"default","tag":"SDK","count":22},{"language":"default","tag":"Features","count":16},{"language":"default","tag":"Platform","count":15},{"language":"default","tag":"Architech","count":13},{"language":"default","tag":"Integrations","count":12},{"language":"default","tag":"Helix Cloud","count":11},{"language":"default","tag":"Reference","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":".nav-logo{height:32px!important;max-height:32px!important}.sidebar-group-header{font-size:14px!important}link[rel=\"icon\"]{width:32px;height:32px}.callout[class*=\"border-neutral\"]{background-color:rgba(126, 71, 215, 0.10)!important;border-color:rgba(126, 71, 215, 0.32)!important}html:not(.dark) #table-of-contents-layout h2,html:not(.dark) #table-of-contents-layout h2 *{color:#4b4a50!important}html:not(.dark) a[href*=\"poweredBy\"]{color:#5f5e63!important}.flow-arrow{color:#6d3cc4}.dark .flow-arrow{color:#a98be8}.flow-rework{color:#b4235a}.dark .flow-rework{color:#f58ba8}.fx-panel{overflow-x:auto;margin:1.5rem 0;padding:12px;border-radius:12px;background:rgba(126, 71, 215, 0.12);border:1px solid rgba(126, 71, 215, 0.4)}.fx-grid{display:grid;row-gap:8px;align-items:stretch}.fx-map{grid-template-columns:minmax(0, 1fr) 24px minmax(0, 1fr) 24px minmax(0, 1fr);min-width:440px}.fx-chain{grid-template-columns:minmax(0, 1fr) 24px minmax(0, 1fr) 24px minmax(0, 1fr);min-width:440px}.fx-head{font-size:12px;font-weight:700;text-transform:uppercase;letter-spacing:0.04em;text-align:center;color:#4b2a8a}.dark .fx-head{color:#c9b5f2}.fx-box{background:#140d22;border:2px solid #7E47D7;color:#ede7f8;border-radius:10px;padding:8px 4px;text-align:center;font-size:13px;font-weight:600;line-height:1.3;display:flex;flex-direction:column;align-items:center;justify-content:center;min-height:52px}.fx-box code{background:transparent;color:#ede7f8;font-size:12px;white-space:normal;overflow-wrap:anywhere;border:0;padding:0}.fx-box small{display:block;margin-top:2px;font-weight:500}.fx-gate{background:#3b2466;border-style:dashed;border-color:#F5B942}.fx-span{grid-row:span 2}.fx-arrow{font-size:22px;font-weight:700;text-align:center;align-self:center}.fx-rework{margin-top:8px;font-size:13px;text-align:center}"}]}
{"page":{"pagePath":"sdk/python/configuration","slug":"/sdk/python/configuration","pageMetadata":{"title":"Configuration","description":"Configure the Mutagent Python SDK client.","href":"/sdk/python/configuration"},"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: \"Configure the Mutagent Python SDK client.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`Mutagent`}),` client (and its async twin `,_jsx(_components.code,{children:`AsyncMutagent`}),`) takes options controlling auth, the API\nendpoint, and timeouts. With no options it reads `,_jsx(_components.code,{children:`MUTAGENT_API_KEY`}),` from the environment and targets\nthe hosted Platform.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mutagent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Mutagent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Mutagent(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` api_key`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003ckey>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# defaults to the MUTAGENT_API_KEY env var`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` server_url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.mutagent.io\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# optional endpoint override`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` timeout`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`30.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# seconds`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`api_key`})}),_jsxs(_components.td,{children:[`Credential. Defaults to the `,_jsx(_components.code,{children:`MUTAGENT_API_KEY`}),` env var.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`server_url`})}),_jsxs(_components.td,{children:[`API endpoint. Defaults to the `,_jsx(_components.code,{children:`MUTAGENT_SERVER_URL`}),` env var, then the hosted Platform.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`timeout`})}),_jsx(_components.td,{children:`Per-request timeout in seconds. Default: 60.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`async`,children:`Async`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mutagent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` AsyncMutagent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`async`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` with`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` AsyncMutagent() `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client:`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#D4D4D4`},children:` ...`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`which-workspace-a-call-acts-in`,children:`Which workspace a call acts in`}),`\n`,_jsxs(_components.p,{children:[`A workspace API key acts in its own workspace. With an organization API key, send the workspace as\nthe `,_jsx(_components.code,{children:`x-workspace-id`}),` header. Set it on an `,_jsx(_components.code,{children:`httpx.Client`}),` and pass that as `,_jsx(_components.code,{children:`http_client`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` httpx`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` mutagent `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Mutagent`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Mutagent(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`http_client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`httpx.Client(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"x-workspace-id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cworkspace-id>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}))`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`([config.name `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` config `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`in`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.llm_providers.list_provider_configs().configs])`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`client.workspaces.list_workspaces()`}),` returns the IDs as `,_jsx(_components.code,{children:`workspaces[].id_`}),`. See\n`,_jsx(_components.a,{href:`/quickstart/api-keys`,children:`API keys`}),` for the two kinds of key.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`Mutagent()`}),` with `,_jsx(_components.code,{children:`MUTAGENT_API_KEY`}),` exported is enough for most scripts. Override `,_jsx(_components.code,{children:`server_url`}),`\nonly for a non-default endpoint.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Configuration","description":"Configure the Mutagent Python SDK client.","href":"/sdk/python/configuration"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Async","slug":"async","depth":2,"children":[]},{"title":"Which workspace a call acts in","slug":"which-workspace-a-call-acts-in","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"architech","siteName":"Mutagent Docs","title":"Configuration - Mutagent Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T12:59:34.469Z","originalFileLocation":"sdk/python/configuration.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Configure the Mutagent Python SDK client.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mutagent Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_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/architech/2H9cAjb5vPD0itYT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configuration - Mutagent Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Configure the Mutagent Python SDK client.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mutagent Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mutagent.io/sdk/python/configuration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://architech.mintlify.site/_mintlify/api/og/v2?division=Python\u0026amp;title=Configuration\u0026amp;description=Configure+the+Mutagent+Python+SDK+client.\u0026amp;theme=04efcec2e743ab4747e912cd\u0026amp;signature=08a9ac98b1dedd9657a1c119ab3765ca41cca96a1ca014ddb031c351c23ea156\">\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=\"Configuration - Mutagent Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Configure the Mutagent Python SDK client.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://architech.mintlify.site/_mintlify/api/og/v2?division=Python\u0026amp;title=Configuration\u0026amp;description=Configure+the+Mutagent+Python+SDK+client.\u0026amp;theme=04efcec2e743ab4747e912cd\u0026amp;signature=08a9ac98b1dedd9657a1c119ab3765ca41cca96a1ca014ddb031c351c23ea156\">\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/architech/2H9cAjb5vPD0itYT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mutagent Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7E47D7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mutagent.io/sdk/python/configuration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/sdk/python/configuration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mutagent.io/#organization\",\"name\":\"Mutagent Docs\",\"url\":\"https://docs.mutagent.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/architech/pR5Pof2Qz2GQVjpo/logo/light-v4.svg?fit=max\u0026auto=format\u0026n=pR5Pof2Qz2GQVjpo\u0026q=85\u0026s=f11adc25a4173de6c845ef141777fe48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mutagent.io#website\",\"name\":\"Mutagent Docs\",\"url\":\"https://docs.mutagent.io\",\"publisher\":{\"@id\":\"https://docs.mutagent.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mutagent.io/sdk/python/configuration#webpage\",\"url\":\"https://docs.mutagent.io/sdk/python/configuration\",\"name\":\"Configuration\",\"description\":\"Configure the Mutagent Python SDK client.\",\"dateModified\":\"2026-11-17T12:59:34.469Z\",\"isPartOf\":{\"@id\":\"https://docs.mutagent.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mutagent.io/sdk/python/configuration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mutagent.io/sdk/python/configuration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SDK\",\"item\":\"https://docs.mutagent.io/sdk/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Python\",\"item\":\"https://docs.mutagent.io/sdk/python/installation\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Configuration\",\"item\":\"https://docs.mutagent.io/sdk/python/configuration\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.mutagent.io/sdk/python/configuration#article\",\"headline\":\"Configuration\",\"name\":\"Configuration\",\"description\":\"Configure the Mutagent Python SDK client.\",\"url\":\"https://docs.mutagent.io/sdk/python/configuration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mutagent.io/sdk/python/configuration#webpage\"},\"dateModified\":\"2026-11-17T12:59:34.469Z\",\"publisher\":{\"@id\":\"https://docs.mutagent.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mutagent.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mutagent Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mutagent Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/sdk/python/configuration.md","siteName":"Mutagent Docs","nav":{"global":null,"tabs":[{"tab":"Factory","pages":[{"title":"Factory","href":"/factory/overview"}]},{"tab":"Helix","pages":[{"title":"Helix","href":"/helix/what-is-helix"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"Platform","pages":[{"title":"Platform","href":"/introduction"}]},{"tab":"SDK","groups":[{"group":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"},{"group":"TypeScript","pages":[{"title":"Installation","href":"/sdk/typescript/installation"},{"title":"Configuration","href":"/sdk/typescript/configuration"},{"title":"LLM providers","href":"/sdk/typescript/providers"},{"title":"Environments and sandbox providers","sidebarTitle":"Environments","href":"/sdk/typescript/environments"},{"title":"Helix Cloud and managed agents","sidebarTitle":"Helix Cloud","href":"/sdk/typescript/helix-cloud"}]},{"group":"Python","pages":[{"title":"Installation","description":"Install the Mutagent Python SDK and make your first call.","href":"/sdk/python/installation"},{"title":"Configuration","href":"/sdk/python/configuration"},{"title":"LLM providers","description":"List, add and test the workspace's LLM providers with the Python SDK.","href":"/sdk/python/providers"},{"title":"Environments and sandbox providers","sidebarTitle":"Environments","href":"/sdk/python/environments"},{"title":"Helix Cloud and managed agents","sidebarTitle":"Helix Cloud","href":"/sdk/python/helix-cloud"}]}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]}]},"basePath":"","title":"Configuration - Mutagent Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}