OAuth 2.0 access token obtained through RFC 8628 at /api/auth/device/code and /api/auth/oauth2/token. The API enforces governance:read, session:write, and client-status:write as appropriate.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Blue","description":"Governance and dynamic extension distribution for coding-agent CLIs, with an optional bring-your-own inference gateway and session capture.","colors":{"primary":"#1D4ED8","light":"#3B82F6","dark":"#3B82F6"},"logo":{"light":"https://mintcdn.com/bluee/QAY5d_4-YqkTu0gf/images/blue.png?fit=max\u0026auto=format\u0026n=QAY5d_4-YqkTu0gf\u0026q=85\u0026s=73095e50e2a7be9c7acd6c3dfd6a585e","dark":"https://mintcdn.com/bluee/QAY5d_4-YqkTu0gf/images/blue.png?fit=max\u0026auto=format\u0026n=QAY5d_4-YqkTu0gf\u0026q=85\u0026s=73095e50e2a7be9c7acd6c3dfd6a585e"},"favicon":"https://mintcdn.com/bluee/QAY5d_4-YqkTu0gf/images/favicon.png?fit=max\u0026auto=format\u0026n=QAY5d_4-YqkTu0gf\u0026q=85\u0026s=00cbc87139a299e7453dbd931879fc7b","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"navbar":{"links":[{"href":"https://github.com/BlocksOrg/blue","label":"GitHub"},{"href":"https://bluee.sh/manifesto","label":"Why Blue"},{"href":"https://github.com/BlocksOrg/blue/blob/main/LICENSE","label":"MIT License"}],"primary":{"type":"button","label":"Get started","href":"/next/quickstart"}},"footer":{"socials":{"github":"https://github.com/BlocksOrg/blue"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bluee","hasAudioNarration":false,"actualSubdomain":"bluee","customDomains":["docs.bluee.sh"],"gitSource":{"type":"github","owner":"blocksorg","repo":"blue","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ab067269a4ee5cbd9510b51","collectionId":"0d0dce88-db6b-435b-9ba2-2ec550029d72","liveDeploymentHistoryId":"6ab067269a4ee5cbd9510b51","schemaVersion":"v3"},"entitlements":{},"buildId":"6ab067269a4ee5cbd9510b51","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":233},{"language":"default","tag":"Administration","count":69},{"language":"default","tag":"Identity provisioning","count":45},{"language":"default","tag":"User management","count":41},{"language":"default","tag":"System","count":33},{"language":"default","tag":"Gateway","count":27},{"language":"default","tag":"Sessions","count":27},{"language":"default","tag":"Concepts","count":17},{"language":"default","tag":"CLI","count":12},{"language":"default","tag":"Deployment","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","slug":"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","pageMetadata":{"title":"Read the organization's current editable YAML configuration","description":null,"deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/governance-config","href":"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","autogeneratedByOpenApi":true},"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":"Read the organization's current editable YAML configuration","description":null,"deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/governance-config","href":"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getAdminGovernanceConfig","tags":["Administration"],"summary":"Read the organization's current editable YAML configuration","responses":{"200":"867880fe-6e50-4537-9b2e-705bd4224e08"},"method":"get","type":"path","servers":["17077fbe-f0d3-41c2-ae3c-aeda7b3919e5"],"security":["0d6bd505-695a-4440-a324-a2a19a9ded6a"],"path":"/admin/governance-config","baseUrlOptions":["https://harness.example.com"],"title":"Read the organization's current editable YAML configuration","description":"","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"867880fe-6e50-4537-9b2e-705bd4224e08":{"description":"Current YAML and revision","content":{"application/json":{"schema":{"type":"object","required":["revision","yaml","managed_yaml","document","package_audiences","created_at"],"properties":{"revision":{"type":"string","format":"uuid","example":"251e6087-98cf-4861-9668-f09f537d5e4d","isRequired":true,"uniqueKey":"revision","typeLabel":"string\u003cuuid>"},"yaml":{"type":"string","description":"Validated organization policy template","isRequired":true,"uniqueKey":"yaml","typeLabel":"string"},"managed_yaml":{"type":"string","description":"Editable policy projection with extension-owned fields omitted","isRequired":true,"uniqueKey":"managed_yaml","typeLabel":"string"},"document":{"type":"object","required":["revision","allowed_harnesses"],"properties":{"revision":{"type":"string","description":"Reconcile key; daemon acts on change","example":"251e6087-98cf-4861-9668-f09f537d5e4d","isRequired":true,"uniqueKey":"document.revision","typeLabel":"string"},"allowed_harnesses":{"type":"array","items":{"type":"string","description":"Harness key from the compiled registry","uniqueKey":"document.allowed_harnesses.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"document.allowed_harnesses","typeLabel":"string[]"},"contract_version":{"type":"integer","default":1,"description":"Governance wire contract version","uniqueKey":"document.contract_version","typeLabel":"integer"},"required_capabilities":{"type":"array","items":{"type":"string","enum":["adapter_intervals","compiled_harness_registry","tenant_client_version_pin","transactional_reconcile","unverified_harness_versions","versioned_state"],"uniqueKey":"document.required_capabilities.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"document.required_capabilities","typeLabel":"enum\u003cstring>[]"},"minimum_client_version":{"type":"string","description":"Operator-visible rollout floor; required capabilities enforce compatibility","uniqueKey":"document.minimum_client_version","typeLabel":"string"},"required_client_version":{"type":"string","description":"Canonical exact SemVer of the recommended Blue CLI release. Defaults to the control API deployment version. Requires tenant_client_version_pin capability.","example":"0.1.0","uniqueKey":"document.required_client_version","typeLabel":"string"},"ttl_seconds":{"type":"integer","description":"Client cache TTL (default 300)","example":300,"uniqueKey":"document.ttl_seconds","typeLabel":"integer"},"required":{"type":"boolean","description":"If true, client fails closed without fresh config","uniqueKey":"document.required","typeLabel":"boolean"},"harnesses":{"type":"object","additionalProperties":{"type":"object","properties":{"version_requirement":{"type":"string","description":"Semver range required for the locally installed harness","uniqueKey":"document.harnesses.additionalProperties.version_requirement","typeLabel":"string"},"allow_unverified_versions":{"type":"boolean","default":false,"description":"Permit matching releases beyond Blue's certified ceiling; requires version_requirement","uniqueKey":"document.harnesses.additionalProperties.allow_unverified_versions","typeLabel":"boolean"},"managed_config":{"type":"object","description":"Known keys are typed; unknown keys are preserved forward-compatibly.","properties":{"model":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.managed_config.model","typeLabel":"string"},"approval_policy":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.managed_config.approval_policy","typeLabel":"string"},"sandbox_mode":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.managed_config.sandbox_mode","typeLabel":"string"},"auto_approve":{"type":"boolean","uniqueKey":"document.harnesses.additionalProperties.managed_config.auto_approve","typeLabel":"boolean"},"reasoning_effort":{"type":"string","description":"Harness model thinking/reasoning effort, such as medium.","uniqueKey":"document.harnesses.additionalProperties.managed_config.reasoning_effort","typeLabel":"string"},"fast_mode":{"type":"boolean","description":"Whether accelerated service-tier selection is available; Codex maps false to features.fast_mode=false and service_tier=default.","uniqueKey":"document.harnesses.additionalProperties.managed_config.fast_mode","typeLabel":"boolean"}},"additionalProperties":true,"uniqueKey":"document.harnesses.additionalProperties.managed_config","typeLabel":"object"},"mcp":{"type":"array","description":"Additive MCP suggestions. An enabled entry is installed only when the local harness has no MCP with the same name; existing local MCPs are never overwritten, disabled, or removed.\n","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].name","typeLabel":"string"},"command":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].command","typeLabel":"string"},"args":{"type":"array","items":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].args.items.[INDEX]","typeLabel":"string"},"uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].args","typeLabel":"string[]"},"env":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].env.additionalProperties","typeLabel":"string"},"uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].env","typeLabel":"object"},"url":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].url","typeLabel":"string"},"transport":{"type":"string","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].transport","typeLabel":"string"},"disabled":{"type":"boolean","uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX].disabled","typeLabel":"boolean"}},"uniqueKey":"document.harnesses.additionalProperties.mcp.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document.harnesses.additionalProperties.mcp","typeLabel":"object[]"},"package_overrides":{"type":"object","additionalProperties":{"type":"object","properties":{"enabled":{"type":"boolean","uniqueKey":"document.harnesses.additionalProperties.package_overrides.additionalProperties.enabled","typeLabel":"boolean"},"settings":{"type":"object","additionalProperties":true,"uniqueKey":"document.harnesses.additionalProperties.package_overrides.additionalProperties.settings","typeLabel":"object"}},"uniqueKey":"document.harnesses.additionalProperties.package_overrides.additionalProperties","typeLabel":"object"},"uniqueKey":"document.harnesses.additionalProperties.package_overrides","typeLabel":"object"}},"uniqueKey":"document.harnesses.additionalProperties","typeLabel":"object"},"uniqueKey":"document.harnesses","typeLabel":"object"},"packages":{"type":"array","items":{"type":"object","required":["id","version","source_ref","sha256"],"properties":{"id":{"type":"string","pattern":"^[a-z0-9-]+$","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].id","typeLabel":"string"},"version":{"type":"string","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].version","typeLabel":"string"},"source_ref":{"type":"string","description":"Immutable HTTPS or local .tar.gz archive","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].source_ref","typeLabel":"string"},"sha256":{"type":"string","pattern":"^[A-Fa-f0-9]{64}$","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].sha256","typeLabel":"string"},"name":{"type":"string","uniqueKey":"document.packages.items.[INDEX].name","typeLabel":"string"},"artifact_id":{"type":"string","format":"uuid","description":"Organization-scoped mirrored artifact","uniqueKey":"document.packages.items.[INDEX].artifact_id","typeLabel":"string\u003cuuid>"},"platform_sources":{"type":"object","description":"Exact `\u003cos>-\u003carch>` archive overrides; clients require a matching entry when this map is present.","additionalProperties":{"type":"object","required":["source_ref","sha256"],"properties":{"source_ref":{"type":"string","description":"Immutable HTTPS or local .tar.gz archive","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].platform_sources.additionalProperties.source_ref","typeLabel":"string"},"sha256":{"type":"string","pattern":"^[A-Fa-f0-9]{64}$","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].platform_sources.additionalProperties.sha256","typeLabel":"string"},"artifact_id":{"type":"string","format":"uuid","description":"Organization-scoped mirrored artifact","uniqueKey":"document.packages.items.[INDEX].platform_sources.additionalProperties.artifact_id","typeLabel":"string\u003cuuid>"}},"uniqueKey":"document.packages.items.[INDEX].platform_sources.additionalProperties","typeLabel":"object"},"uniqueKey":"document.packages.items.[INDEX].platform_sources","typeLabel":"object"},"settings":{"type":"object","additionalProperties":true,"uniqueKey":"document.packages.items.[INDEX].settings","typeLabel":"object"},"adapters":{"type":"object","additionalProperties":{"type":"object","description":"All paths are archive-root-relative. skills_dir may identify an exact skill folder or a collection of skill folders. Codex/Claude agents and hooks require plugin_dir; OpenCode hooks are declared as plugin modules.\n","properties":{"introduced":{"type":"string","description":"Inclusive harness-version lower bound for adapter availability; defaults to 0.0.0","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.introduced","typeLabel":"string"},"before":{"type":"string","description":"Exclusive harness-version upper bound for adapter availability","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.before","typeLabel":"string"},"plugin_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.plugin_dir","typeLabel":"string"},"skills_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.skills_dir","typeLabel":"string"},"agents_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.agents_dir","typeLabel":"string"},"hooks_file":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.hooks_file","typeLabel":"string"},"plugins":{"type":"array","items":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.plugins.items.[INDEX]","typeLabel":"string"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.plugins","typeLabel":"string[]"},"helpers":{"type":"object","additionalProperties":{"type":"object","properties":{"paths":{"type":"object","description":"Archive paths keyed by os-architecture, with optional default.","additionalProperties":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.helpers.additionalProperties.paths.additionalProperties","typeLabel":"string"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.helpers.additionalProperties.paths","typeLabel":"object"}},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.helpers.additionalProperties","typeLabel":"object"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.helpers","typeLabel":"object"},"variants":{"type":"array","description":"Ordered half-open layouts selected within adapter availability; intervals must not overlap or leave gaps without a fallback.","items":{"type":"object","required":["introduced"],"properties":{"introduced":{"type":"string","description":"Inclusive semantic-version lower bound","isRequired":true,"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].introduced","typeLabel":"string"},"before":{"type":"string","description":"Exclusive semantic-version upper bound; omit for open-ended","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].before","typeLabel":"string"},"plugin_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].plugin_dir","typeLabel":"string"},"skills_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].skills_dir","typeLabel":"string"},"agents_dir":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].agents_dir","typeLabel":"string"},"hooks_file":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].hooks_file","typeLabel":"string"},"plugins":{"type":"array","items":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].plugins.items.[INDEX]","typeLabel":"string"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].plugins","typeLabel":"string[]"},"helpers":{"type":"object","additionalProperties":{"type":"object","properties":{"paths":{"type":"object","description":"Archive paths keyed by os-architecture, with optional default.","additionalProperties":{"type":"string","uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].helpers.additionalProperties.paths.additionalProperties","typeLabel":"string"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].helpers.additionalProperties.paths","typeLabel":"object"}},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].helpers.additionalProperties","typeLabel":"object"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX].helpers","typeLabel":"object"}},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties.variants","typeLabel":"object[]"}},"uniqueKey":"document.packages.items.[INDEX].adapters.additionalProperties","typeLabel":"object"},"uniqueKey":"document.packages.items.[INDEX].adapters","typeLabel":"object"}},"uniqueKey":"document.packages.items.[INDEX]","typeLabel":"object"},"uniqueKey":"document.packages","typeLabel":"object[]"},"gateway":{"type":"object","required":["type"],"description":"Present ⇒ gateway mode for every allowed harness; omit ⇒ governance-only. proxy_url and token are runtime fields injected by the control API when it delivers the policy to an authenticated client.\n","properties":{"type":{"type":"string","description":"Deployment-defined gateway adapter identifier.","isRequired":true,"uniqueKey":"document.gateway.type","typeLabel":"string"},"proxy_url":{"type":"string","description":"Runtime inference proxy URL injected at delivery time","uniqueKey":"document.gateway.proxy_url","typeLabel":"string"},"token":{"type":"string","description":"Runtime-only, session-bound inference JWT. The inference proxy validates it and swaps it for an upstream gateway credential. The control API injects it into the authenticated client's config response and never persists it.\n","uniqueKey":"document.gateway.token","typeLabel":"string"},"auth_style":{"type":"string","enum":["bearer"],"default":"bearer","description":"Client-to-proxy authentication style; bearer is the only supported value.","uniqueKey":"document.gateway.auth_style","typeLabel":"enum\u003cstring>"}},"uniqueKey":"document.gateway","typeLabel":"object"},"session_upload":{"type":"object","required":["presign_url"],"description":"Global opt-in portable-session capture. When present, every compatible supported harness registers its native hook. The authenticated endpoint returns a short-lived provider-specific blob upload request.\n","properties":{"presign_url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"document.session_upload.presign_url","typeLabel":"string\u003curi>"}},"uniqueKey":"document.session_upload","typeLabel":"object"},"telemetry":{"type":"object","properties":{"sink_url":{"type":"string","uniqueKey":"document.telemetry.sink_url","typeLabel":"string"}},"uniqueKey":"document.telemetry","typeLabel":"object"}},"isRequired":true,"uniqueKey":"document","typeLabel":"object"},"package_audiences":{"type":"object","description":"Revision-scoped deployment audience keyed by package ID; absent historical records are returned as organization-wide.","additionalProperties":{"type":"object","required":["scope","user_ids"],"properties":{"scope":{"type":"string","enum":["organization","users"],"isRequired":true,"uniqueKey":"package_audiences.additionalProperties.scope","typeLabel":"enum\u003cstring>"},"user_ids":{"type":"array","uniqueItems":true,"items":{"type":"string","format":"uuid","uniqueKey":"package_audiences.additionalProperties.user_ids.items.[INDEX]","typeLabel":"string\u003cuuid>"},"isRequired":true,"uniqueKey":"package_audiences.additionalProperties.user_ids","typeLabel":"string\u003cuuid>[]"}},"uniqueKey":"package_audiences.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"package_audiences","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"revision":"251e6087-98cf-4861-9668-f09f537d5e4d","yaml":"\u003cstring>","managed_yaml":"\u003cstring>","document":{"revision":"251e6087-98cf-4861-9668-f09f537d5e4d","allowed_harnesses":["\u003cstring>"],"contract_version":1,"required_capabilities":["adapter_intervals"],"minimum_client_version":"\u003cstring>","required_client_version":"0.1.0","ttl_seconds":300,"required":true,"harnesses":{},"packages":[{"id":"\u003cstring>","version":"\u003cstring>","source_ref":"\u003cstring>","sha256":"\u003cstring>","name":"\u003cstring>","artifact_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","platform_sources":{},"settings":{},"adapters":{}}],"gateway":{"type":"\u003cstring>","proxy_url":"\u003cstring>","token":"\u003cstring>","auth_style":"bearer"},"session_upload":{"presign_url":"\u003cstring>"},"telemetry":{"sink_url":"\u003cstring>"}},"package_audiences":{},"created_at":"2023-11-07T05:31:56Z"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0d6bd505-695a-4440-a324-a2a19a9ded6a":{"oauthDevice":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth 2.0 access token obtained through RFC 8628 at /api/auth/device/code and /api/auth/oauth2/token. The API enforces governance:read, session:write, and client-status:write as appropriate.\n","scopes":[]}}},"servers":{"17077fbe-f0d3-41c2-ae3c-aeda7b3919e5":{"url":"https://harness.example.com","description":"Replace with the Control API URL for your deployment."}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"OAuth 2.0 access token obtained through RFC 8628 at /api/auth/device/code and /api/auth/oauth2/token. The API enforces governance:read, session:write, and client-status:write as appropriate.\n","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"OAuth 2.0 access token obtained through RFC 8628 at /api/auth/device/code and /api/auth/oauth2/token. The API enforces governance:read, session:write, and client-status:write as appropriate.\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauthDevice","name":"Authorization"}],"title":"oauthDevice"}]},"originalFileLocation":"openapi/next.yaml"},"subdomain":"bluee","siteName":"Blue","title":"Read the organization's current editable YAML configuration - Blue","navMaps":{"firstHrefInVersion":{"0.2.0":{"href":"/0.2.0/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","matchLevel":1},"Next":{"href":"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","matchLevel":0},"0.1.0":{"href":"/0.1.0/api-reference/administration/read-the-organizations-current-editable-yaml-configuration","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T23:07:25.646Z","originalFileLocation":"next/api-reference/administration/read-the-organizations-current-editable-yaml-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=\"application-name\" content=\"Blue\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_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/bluee/3l8WFSZ874gogX_t/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read the organization\u0026#x27;s current editable YAML configuration - Blue\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Blue\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bluee.mintlify.app/_mintlify/api/og/v2?division=Administration\u0026amp;title=Read+the+organization%27s+current+editable+YAML+configuration\u0026amp;theme=9246b0c56022c4ff318736e8\u0026amp;signature=984230d38f6fd4df1de96767dd5d9911145caca42fe73bba3a66f17d48e7dc40\">\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=\"Read the organization\u0026#x27;s current editable YAML configuration - Blue\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bluee.mintlify.app/_mintlify/api/og/v2?division=Administration\u0026amp;title=Read+the+organization%27s+current+editable+YAML+configuration\u0026amp;theme=9246b0c56022c4ff318736e8\u0026amp;signature=984230d38f6fd4df1de96767dd5d9911145caca42fe73bba3a66f17d48e7dc40\">\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/bluee/3l8WFSZ874gogX_t/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Blue\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1D4ED8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bluee.sh/#organization\",\"name\":\"Blue\",\"url\":\"https://docs.bluee.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bluee/QAY5d_4-YqkTu0gf/images/blue.png?fit=max\u0026auto=format\u0026n=QAY5d_4-YqkTu0gf\u0026q=85\u0026s=73095e50e2a7be9c7acd6c3dfd6a585e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bluee.sh#website\",\"name\":\"Blue\",\"url\":\"https://docs.bluee.sh\",\"publisher\":{\"@id\":\"https://docs.bluee.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration#webpage\",\"url\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration\",\"name\":\"Read the organization's current editable YAML configuration\",\"dateModified\":\"2026-09-20T23:07:25.646Z\",\"isPartOf\":{\"@id\":\"https://docs.bluee.sh#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://docs.bluee.sh/next/api-reference/system/discover-control-api-and-oauth-device-flow-settings\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read the organization's current editable YAML configuration\",\"item\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration#apireference\",\"headline\":\"Read the organization's current editable YAML configuration\",\"name\":\"Read the organization's current editable YAML configuration\",\"url\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bluee.sh/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration#webpage\"},\"dateModified\":\"2026-09-20T23:07:25.646Z\",\"publisher\":{\"@id\":\"https://docs.bluee.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bluee.sh#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Blue\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Blue","nav":{"global":null,"versions":[{"version":"0.2.0","pages":[{"title":"0.2.0","href":"/0.2.0/api-reference/administration/read-the-organizations-current-editable-yaml-configuration"}]},{"version":"Next","groups":[{"group":"Start here","pages":[{"title":"Blue","icon":"shield-halved","href":"/next/introduction"},{"title":"Quickstart","icon":"rocket","href":"/next/quickstart"}]},{"group":"Deployment","pages":[{"title":"Deployment contract","icon":"list-check","href":"/next/deployment/runtime-contract"},{"title":"Kubernetes with Helm","icon":"server","href":"/next/deployment/production"},{"title":"Configure blue.yaml","icon":"file-code","href":"/next/deployment/blue-yaml"},{"title":"Managed repository connections","icon":"folder-tree","href":"/next/deployment/managed-repositories"}]},{"group":"Concepts","pages":[{"title":"Architecture","icon":"diagram-project","href":"/next/concepts/architecture"},{"title":"Configuration lifecycle","icon":"sliders","href":"/next/concepts/configuration"},{"title":"Managed configuration","icon":"layer-group","href":"/next/concepts/managed-configuration"},{"title":"Harness version compatibility","icon":"code-branch","href":"/next/concepts/harness-version-compatibility"},{"title":"Bring your own gateway","icon":"route","href":"/next/concepts/gateway-mode"},{"title":"Authentication and authorization","icon":"key","href":"/next/concepts/authentication"}]},{"group":"CLI","pages":[{"title":"CLI commands","icon":"terminal","href":"/next/cli/commands"},{"title":"Supported harnesses","icon":"code","href":"/next/cli/harnesses"},{"title":"Windows paths and migration","icon":"folder-tree","href":"/next/cli/windows-paths"},{"title":"Troubleshooting","icon":"wrench","href":"/next/cli/troubleshooting"}]},{"group":"Administration","pages":[{"title":"Dashboard administration","icon":"gauge-high","href":"/next/admin/dashboard"},{"title":"Manage users and invitations","icon":"users","href":"/next/admin/user-management"},{"title":"Set up Okta SSO and SCIM","icon":"id-card","href":"/next/admin/identity-provisioning"},{"title":"Managed packages","icon":"box-open","href":"/next/admin/managed-packages"},{"title":"Manage organization policy","icon":"file-pen","href":"/next/admin/configuration"},{"title":"Gateway access","icon":"route","href":"/next/admin/gateway-access"},{"title":"Custom gateway provisioners","icon":"gears","href":"/next/admin/custom-gateway-provisioners"},{"title":"Session capture","icon":"file-shield","href":"/next/admin/session-capture"}]},{"group":"Development","pages":[{"title":"Local development with Docker Compose","icon":"docker","href":"/next/development/local-compose"},{"title":"Contributing","icon":"code-pull-request","href":"/next/development/contributing"},{"title":"Harness adapter architecture","icon":"code-branch","href":"/next/development/harness-adapter-architecture"},{"title":"Gateway adapter architecture","icon":"route","href":"/next/development/gateway-adapter-architecture"}]},{"group":"Reference","pages":[{"title":"Governance configuration","icon":"file-code","href":"/next/reference/governance-config"},{"title":"Authentication endpoints","icon":"fingerprint","href":"/next/reference/auth-endpoints"}]},{"group":"API reference","pages":[{"group":"System","pages":[{"title":"Discover Control API and OAuth device-flow settings","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /.well-known/metaharness","href":"/next/api-reference/system/discover-control-api-and-oauth-device-flow-settings"},{"title":"Liveness probe","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health","href":"/next/api-reference/system/liveness-probe"},{"title":"Readiness probe","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /ready","href":"/next/api-reference/system/readiness-probe"},{"title":"Check database schema compatibility","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health/schema","href":"/next/api-reference/system/check-database-schema-compatibility"},{"title":"Check singleton background-worker freshness","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health/worker","href":"/next/api-reference/system/check-singleton-background-worker-freshness"},{"title":"Check session and package object stores","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health/object-storage","href":"/next/api-reference/system/check-session-and-package-object-stores"},{"title":"Check the gateway credential resolver store","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health/credential-resolver","href":"/next/api-reference/system/check-the-gateway-credential-resolver-store"},{"title":"Prometheus metrics","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /metrics","href":"/next/api-reference/system/prometheus-metrics"},{"title":"Check Control API dependencies","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /health/dependencies","href":"/next/api-reference/system/check-control-api-dependencies"},{"title":"Fetch deployment-wide dashboard branding","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /branding","href":"/next/api-reference/system/fetch-deployment-wide-dashboard-branding"},{"title":"Resolve the current OAuth token or dashboard session","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /auth/me","href":"/next/api-reference/system/resolve-the-current-oauth-token-or-dashboard-session"}]},{"group":"Gateway","pages":[{"title":"Get inference JWT verification keys","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /gateway/jwks","href":"/next/api-reference/gateway/get-inference-jwt-verification-keys"},{"title":"Revoke the gateway session bound to the current OAuth session","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /gateway/session/revoke","href":"/next/api-reference/gateway/revoke-the-gateway-session-bound-to-the-current-oauth-session"},{"title":"Describe gateway policy and runtime readiness without contacting the gateway","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /gateway/status","href":"/next/api-reference/gateway/describe-gateway-policy-and-runtime-readiness-without-contacting-the-gateway"},{"title":"Ping the configured inference proxy","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /gateway/proxy/health","href":"/next/api-reference/gateway/ping-the-configured-inference-proxy"},{"title":"Get the authenticated user's managed gateway-key status","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /gateway/key","href":"/next/api-reference/gateway/get-the-authenticated-users-managed-gateway-key-status"},{"title":"Provision or reconcile the authenticated user's managed gateway key","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /gateway/key/ensure","href":"/next/api-reference/gateway/provision-or-reconcile-the-authenticated-users-managed-gateway-key"},{"title":"Validate the authenticated user's stored upstream gateway key","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /gateway/key/validate","href":"/next/api-reference/gateway/validate-the-authenticated-users-stored-upstream-gateway-key"},{"title":"List organization inference-proxy request metadata","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /gateway/request-logs","href":"/next/api-reference/gateway/list-organization-inference-proxy-request-metadata"},{"title":"List organization request-log filter values","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /gateway/request-logs/facets","href":"/next/api-reference/gateway/list-organization-request-log-filter-values"}]},{"group":"Configuration","pages":[{"title":"Fetch the governance config for the authenticated user/org","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /governance-config","href":"/next/api-reference/configuration/fetch-the-governance-config-for-the-authenticated-userorg"},{"title":"Return the trusted compiled harness registry","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /harness-metadata","href":"/next/api-reference/configuration/return-the-trusted-compiled-harness-registry"},{"title":"Watch organization governance revision changes","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /governance-config/events","href":"/next/api-reference/configuration/watch-organization-governance-revision-changes"},{"title":"Report a local client's applied revision and managed-file health","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /client-status","href":"/next/api-reference/configuration/report-a-local-clients-applied-revision-and-managed-file-health"}]},{"group":"Sessions","pages":[{"title":"Create a short-lived session artifact upload request","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /session-uploads/presign","href":"/next/api-reference/sessions/create-a-short-lived-session-artifact-upload-request"},{"title":"List captured sessions visible to the caller","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /session-uploads","href":"/next/api-reference/sessions/list-captured-sessions-visible-to-the-caller"},{"title":"List users and harnesses available as captured-session filters","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /session-uploads/facets","href":"/next/api-reference/sessions/list-users-and-harnesses-available-as-captured-session-filters"},{"title":"Search active organization members for session sharing","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /session-uploads/members","href":"/next/api-reference/sessions/search-active-organization-members-for-session-sharing"},{"title":"Get captured-session metadata and artifact history","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /session-uploads/{id}","href":"/next/api-reference/sessions/get-captured-session-metadata-and-artifact-history"},{"title":"Verify the uploaded object and commit its metadata","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /session-uploads/{id}/complete","href":"/next/api-reference/sessions/verify-the-uploaded-object-and-commit-its-metadata"},{"title":"Create a short-lived download request for the current artifact","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /session-uploads/{id}/download","href":"/next/api-reference/sessions/create-a-short-lived-download-request-for-the-current-artifact"},{"title":"Get the current sharing mode and active recipients","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /session-uploads/{id}/sharing","href":"/next/api-reference/sessions/get-the-current-sharing-mode-and-active-recipients"},{"title":"Replace owner-managed session sharing grants","description":"Idempotently sets private, workspace-wide, or selected-active-member access. Only the owner may call this endpoint.","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /session-uploads/{id}/sharing","href":"/next/api-reference/sessions/replace-owner-managed-session-sharing-grants"}]},{"group":"Administration","pages":[{"title":"Read the organization's current editable YAML configuration","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/governance-config","href":"/next/api-reference/administration/read-the-organizations-current-editable-yaml-configuration"},{"title":"Validate and save a new governance configuration revision","description":null,"deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /admin/governance-config","href":"/next/api-reference/administration/validate-and-save-a-new-governance-configuration-revision"},{"title":"List recent governance configuration revisions","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/governance-config/revisions","href":"/next/api-reference/administration/list-recent-governance-configuration-revisions"},{"title":"Export the mounted deployment configuration with current governance","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/blue-config/export","href":"/next/api-reference/administration/export-the-mounted-deployment-configuration-with-current-governance"},{"title":"Replace deployment-wide dashboard branding","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /admin/branding","href":"/next/api-reference/administration/replace-deployment-wide-dashboard-branding"},{"title":"List curated extension packages available to the organization","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/package-catalog","href":"/next/api-reference/administration/list-curated-extension-packages-available-to-the-organization"},{"title":"Resolve, hash, and optionally mirror a managed repository source","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/package-source/inspect","href":"/next/api-reference/administration/resolve-hash-and-optionally-mirror-a-managed-repository-source"},{"title":"List repository connections allowed for the administrator's organization","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/package-source/connections","href":"/next/api-reference/administration/list-repository-connections-allowed-for-the-administrators-organization"},{"title":"Save packages, per-harness overrides, and MCP servers as a new revision","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /admin/governance-extensions","href":"/next/api-reference/administration/save-packages-per-harness-overrides-and-mcp-servers-as-a-new-revision"},{"title":"Read one coding agent's managed configuration as YAML","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/harnesses/{harness}/managed-config","href":"/next/api-reference/administration/read-one-coding-agents-managed-configuration-as-yaml"},{"title":"Save one coding agent's managed configuration as a new revision","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /admin/harnesses/{harness}/managed-config","href":"/next/api-reference/administration/save-one-coding-agents-managed-configuration-as-a-new-revision"},{"title":"Read every supported coding agent's managed configuration as YAML","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/harnesses/managed-configs","href":"/next/api-reference/administration/read-every-supported-coding-agents-managed-configuration-as-yaml"},{"title":"List and filter local client status reports for the organization","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/client-status","href":"/next/api-reference/administration/list-and-filter-local-client-status-reports-for-the-organization"},{"title":"List users and harnesses available as client-status filters","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/client-status/facets","href":"/next/api-reference/administration/list-users-and-harnesses-available-as-client-status-filters"},{"title":"Remove an organization client inventory record","deprecated":null,"version":null,"openapi":"/openapi/next.yaml delete /admin/client-status/{id}","href":"/next/api-reference/administration/remove-an-organization-client-inventory-record"}]},{"group":"Governance","pages":[{"title":"Create a short-lived download request for an organization-scoped package artifact","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /package-artifacts/{id}/download","href":"/next/api-reference/governance/create-a-short-lived-download-request-for-an-organization-scoped-package-artifact"}]},{"group":"User management","pages":[{"title":"Get the deployment-managed identity and provisioning status","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/identity/status","href":"/next/api-reference/user-management/get-the-deployment-managed-identity-and-provisioning-status"},{"title":"List users in the administrator's organization","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/users","href":"/next/api-reference/user-management/list-users-in-the-administrators-organization"},{"title":"List non-removed organization users for selection controls","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/users/options","href":"/next/api-reference/user-management/list-non-removed-organization-users-for-selection-controls"},{"title":"Search active and already-selected organization users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/users/options","href":"/next/api-reference/user-management/search-active-and-already-selected-organization-users"},{"title":"Get an organization user","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/users/{id}","href":"/next/api-reference/user-management/get-an-organization-user"},{"title":"Delete a user's account access while retaining governance history","deprecated":null,"version":null,"openapi":"/openapi/next.yaml delete /admin/users/{id}","href":"/next/api-reference/user-management/delete-a-users-account-access-while-retaining-governance-history"},{"title":"Change a user's role or active/suspended state","deprecated":null,"version":null,"openapi":"/openapi/next.yaml patch /admin/users/{id}","href":"/next/api-reference/user-management/change-a-users-role-or-activesuspended-state"},{"title":"Revoke all browser, OAuth, and device sessions for a user","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/users/{id}/sessions/revoke","href":"/next/api-reference/user-management/revoke-all-browser-oauth-and-device-sessions-for-a-user"},{"title":"List organization invitations","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/invitations","href":"/next/api-reference/user-management/list-organization-invitations"},{"title":"Invite an email address to create an organization account","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/invitations","href":"/next/api-reference/user-management/invite-an-email-address-to-create-an-organization-account"},{"title":"Get an organization invitation","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /admin/invitations/{id}","href":"/next/api-reference/user-management/get-an-organization-invitation"},{"title":"Cancel a pending invitation","deprecated":null,"version":null,"openapi":"/openapi/next.yaml delete /admin/invitations/{id}","href":"/next/api-reference/user-management/cancel-a-pending-invitation"},{"title":"Resend and renew a pending or expired invitation for 24 hours","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/invitations/{id}/resend","href":"/next/api-reference/user-management/resend-and-renew-a-pending-or-expired-invitation-for-24-hours"},{"title":"Replace an outstanding invitation with a new invitation link","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /admin/invitations/{id}/regenerate","href":"/next/api-reference/user-management/replace-an-outstanding-invitation-with-a-new-invitation-link"}]},{"group":"Identity provisioning","pages":[{"title":"List or equality-filter provisioned users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/Users","href":"/next/api-reference/identity-provisioning/list-or-equality-filter-provisioned-users"},{"title":"Provision a passwordless user","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /scim/v2/Users","href":"/next/api-reference/identity-provisioning/provision-a-passwordless-user"},{"title":"Get scimv2users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/Users/{id}","href":"/next/api-reference/identity-provisioning/get-scimv2users"},{"title":"Put scimv2users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /scim/v2/Users/{id}","href":"/next/api-reference/identity-provisioning/put-scimv2users"},{"title":"Delete scimv2users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml delete /scim/v2/Users/{id}","href":"/next/api-reference/identity-provisioning/delete-scimv2users"},{"title":"Patch scimv2users","deprecated":null,"version":null,"openapi":"/openapi/next.yaml patch /scim/v2/Users/{id}","href":"/next/api-reference/identity-provisioning/patch-scimv2users"},{"title":"Get scimv2groups","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/Groups","href":"/next/api-reference/identity-provisioning/get-scimv2groups"},{"title":"Post scimv2groups","deprecated":null,"version":null,"openapi":"/openapi/next.yaml post /scim/v2/Groups","href":"/next/api-reference/identity-provisioning/post-scimv2groups"},{"title":"Get scimv2groups 1","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/Groups/{id}","href":"/next/api-reference/identity-provisioning/get-scimv2groups-1"},{"title":"Put scimv2groups","deprecated":null,"version":null,"openapi":"/openapi/next.yaml put /scim/v2/Groups/{id}","href":"/next/api-reference/identity-provisioning/put-scimv2groups"},{"title":"Delete scimv2groups","deprecated":null,"version":null,"openapi":"/openapi/next.yaml delete /scim/v2/Groups/{id}","href":"/next/api-reference/identity-provisioning/delete-scimv2groups"},{"title":"Patch scimv2groups","deprecated":null,"version":null,"openapi":"/openapi/next.yaml patch /scim/v2/Groups/{id}","href":"/next/api-reference/identity-provisioning/patch-scimv2groups"},{"title":"Get scimv2serviceproviderconfig","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/ServiceProviderConfig","href":"/next/api-reference/identity-provisioning/get-scimv2serviceproviderconfig"},{"title":"Get scimv2resourcetypes","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/ResourceTypes","href":"/next/api-reference/identity-provisioning/get-scimv2resourcetypes"},{"title":"Get scimv2schemas","deprecated":null,"version":null,"openapi":"/openapi/next.yaml get /scim/v2/Schemas","href":"/next/api-reference/identity-provisioning/get-scimv2schemas"}]}]}]},{"version":"0.1.0","pages":[{"title":"0.1.0","href":"/0.1.0/api-reference/administration/read-the-organizations-current-editable-yaml-configuration"}]}]},"title":"Read the organization's current editable YAML configuration - Blue","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}