For full details on all Configuration fields, see Configuration.
This endpoint uses PATCH semantics — omitted fields are not touched. Only configuration_id is required; include only the fields you want to change.
extraction_fields is not a simple replacement — it uses a merge-by-name strategy. Any existing field not included in your request will be removed. Always send the complete desired list of fields, not just the ones you’re changing.
The type of an existing extraction field cannot be changed. Attempting to do so returns a 400 error. To change a field type, delete and recreate the configuration.
tag cannot be updated — it is immutable after creation. See Configuration.
vocabulary and webhooks are fully replaced by whatever you send. To remove webhooks entirely, pass "webhooks": null.
Merge-by-name strategy. Existing fields can have their description updated but their type is immutable. New fields (name not already present) must include type and description. Fields not included in this list are removed. Maximum 10 fields total.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Heify Docs","colors":{"primary":"#3B82F6","light":"#60A5FA","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/light.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=3239fc52dcd6309d024795459614038d","dark":"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/dark.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=28818c1e279567bb2c6104530b7ea8d0"},"favicon":"https://mintcdn.com/heify/SlX89gyPo8IeHqZ-/favicon.png?fit=max\u0026auto=format\u0026n=SlX89gyPo8IeHqZ-\u0026q=85\u0026s=a3cc859f6117001d46d83feb47c4ebbb","api":{"openapi":["api-reference/openapi-configurations.json","api-reference/openapi-transcriptions.json","api-reference/openapi-evaluators.json","api-reference/openapi-participants.json"],"playground":{"display":"interactive"},"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://api.heify.com"}},"navbar":{"links":[{"href":"https://www.heify.com/contact.html","label":"Contact"}],"primary":{"type":"button","label":"Get API Key","href":"https://sandbox.heify.com/sandbox/api-keys"}},"footer":{"socials":{"linkedin":"https://linkedin.com/company/heify"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://sandbox.heify.com"},{"anchor":"Support","icon":"headset","href":"https://www.heify.com/contact.html"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"heify","hasAudioNarration":false,"actualSubdomain":"heify","customDomains":["docs.heify.com"],"gitSource":{"type":"github","owner":"pablosierrafernandez","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a858fff4866d053b8e4da71","collectionId":"ae164c56-04e8-4106-9ac6-49be695e58db","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a858fff4866d053b8e4da71"},"entitlements":{},"buildId":"6ae93fc9ed8a723d641f5b61:success","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":23},{"language":"default","tag":"Sandbox","count":11},{"language":"default","tag":"Documentation","count":10},{"language":"default","tag":"Transcriptions","count":8},{"language":"default","tag":"Configurations","count":6},{"language":"default","tag":"Evaluators","count":6},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Modules","count":6},{"language":"default","tag":"Participants","count":5},{"language":"default","tag":"Core Objects","count":4}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/configuration/update","slug":"/api-reference/configuration/update","pageMetadata":{"title":"Update Configuration","description":"Partially update an existing configuration. Only fields included in the request body are modified.","openapi":"api-reference/openapi-configurations.json POST /update-configuration","href":"/api-reference/configuration/update"},"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: \"Partially update an existing configuration. Only fields included in the request body are modified.\"\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`,strong:`strong`,..._provideComponents(),...props.components},{Info,Note,Warning}=_components;if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`For full details on all Configuration fields, see `,_jsx(_components.a,{href:`/core/configuration`,children:`Configuration`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This endpoint uses `,_jsx(_components.strong,{children:`PATCH semantics`}),` — omitted fields are not touched. Only `,_jsx(_components.code,{children:`configuration_id`}),` is required; include only the fields you want to change.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`extraction_fields`}),` is not a simple replacement — it uses a merge-by-name strategy.`]}),` Any existing field `,_jsx(_components.strong,{children:`not included`}),` in your request will be `,_jsx(_components.strong,{children:`removed`}),`. Always send the complete desired list of fields, not just the ones you’re changing.`]})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`type`}),` of an existing extraction field `,_jsx(_components.strong,{children:`cannot be changed`}),`. Attempting to do so returns a `,_jsx(_components.code,{children:`400`}),` error. To change a field type, delete and recreate the configuration.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`tag`}),` cannot be updated — it is immutable after creation. See `,_jsx(_components.a,{href:`/core/configuration#tag`,children:`Configuration`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`vocabulary`}),` and `,_jsx(_components.code,{children:`webhooks`}),` are `,_jsx(_components.strong,{children:`fully replaced`}),` by whatever you send. To remove webhooks entirely, pass `,_jsx(_components.code,{children:`\"webhooks\": null`}),`.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`404`}),` if the configuration is not found.`]})})]})}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":"Update Configuration","description":"Partially update an existing configuration. Only fields included in the request body are modified.","openapi":"api-reference/openapi-configurations.json POST /update-configuration","href":"/api-reference/configuration/update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Update a Configuration","description":"Partially update an existing configuration. Only fields included in the request body are modified.","requestBody":"4ce32232-6d1a-46e4-9145-a3db04837d35","responses":{"200":"5ed6c118-0ae2-4dfb-9f5f-8e36389e49d5"},"method":"post","type":"path","servers":["81193391-b870-41d7-aa11-1febb5b8a0cc"],"security":["581956a4-2ed6-4337-9690-f86701ed1cf0"],"path":"/update-configuration","baseUrlOptions":["https://api.heify.com"],"title":"Update a Configuration","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"configuration_id":{"type":"string","format":"uuid","description":"The unique identifier of the configuration to update.","isRequired":true,"uniqueKey":"configuration_id","typeLabel":"string\u003cuuid>"},"vocabulary":{"type":"array","items":{"type":"string","uniqueKey":"vocabulary.items.[INDEX]","typeLabel":"string"},"description":"**Full replacement.** Replaces the entire existing vocabulary list. Example: `[\"Heify\", \"NLP\", \"SLA\"]`.","uniqueKey":"vocabulary","typeLabel":"string[]"},"extraction_fields":{"type":"array","description":"**Merge-by-name strategy.** Existing fields can have their `description` updated but their `type` is immutable. New fields (name not already present) must include `type` and `description`. Fields not included in this list are **removed**. Maximum 10 fields total.","maxItems":10,"items":{"type":"object","properties":{"name":{"type":"string","description":"Field identifier. Auto-normalized on creation: lowercased, accents removed, special characters replaced with `_`. Example: `\"Customer ID\"` → `\"customer_id\"`.","maxLength":50,"isRequired":true,"uniqueKey":"extraction_fields.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","description":"Expected data type of the extracted value. **Immutable after creation.**","enum":["string","number","boolean","array"],"isRequired":true,"uniqueKey":"extraction_fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"Instructions for the AI on what to extract. The more specific, the better the accuracy. Example: `\"Classify the overall sentiment. Must be one of: POSITIVE, NEGATIVE, or NEUTRAL.\"`","maxLength":1000,"isRequired":true,"uniqueKey":"extraction_fields.items.[INDEX].description","typeLabel":"string"}},"additionalProperties":false,"required":["name","type","description"],"uniqueKey":"extraction_fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"extraction_fields","typeLabel":"object[]"},"webhooks":{"oneOf":[{"type":"object","description":"**Full replacement.** Pass `null` to remove webhooks entirely.","properties":{"success_url":{"type":"string","format":"uri","description":"Receives a POST request with the full transcription result on success.","uniqueKey":"webhooks.oneOf.0.success_url","typeLabel":"string\u003curi>"},"error_url":{"type":"string","format":"uri","description":"Receives a POST request with error details on failure.","uniqueKey":"webhooks.oneOf.0.error_url","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"webhooks.oneOf.0","typeLabel":"object"},{"type":"null","description":"**Full replacement.** Pass `null` to remove webhooks entirely.","uniqueKey":"webhooks.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhooks","typeLabel":"object | null"},"summary":{"type":"boolean","description":"Enable or disable automatic AI summary generation.","uniqueKey":"summary","typeLabel":"boolean"},"custom_summary":{"oneOf":[{"type":"string","maxLength":300,"description":"Custom prompt guiding the AI summary. Pass `null` to clear. Only applies when `summary` is `true`.","uniqueKey":"custom_summary.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":300,"description":"Custom prompt guiding the AI summary. Pass `null` to clear. Only applies when `summary` is `true`.","uniqueKey":"custom_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_summary","typeLabel":"string | null"},"summary_language":{"type":"string","description":"Language for the generated summary. Use `\"df\"` for auto-detect. See [Supported Languages](/core/transcription#supported-languages).","uniqueKey":"summary_language","typeLabel":"string"},"analytics_language":{"type":"string","description":"Language for analytics reports. Use `\"df\"` for auto-detect. See [Supported Languages](/core/transcription#supported-languages).","uniqueKey":"analytics_language","typeLabel":"string"}},"required":["configuration_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"UpdateExample":{"title":"UpdateExample","value":{"configuration_id":"a1b2c3d4-e5f6-7890-1234-567890abcdef","summary":true,"summary_language":"en","custom_summary":"Focus on key decisions and action items.","vocabulary":["Heify","NLP"],"extraction_fields":[{"name":"sentiment_analysis","type":"string","description":"Classify the sentiment as POSITIVE, NEGATIVE, or NEUTRAL."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"5ed6c118-0ae2-4dfb-9f5f-8e36389e49d5":{"description":"Configuration updated successfully. Returns the full updated configuration object.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"message":{"type":"string","description":"Confirmation message.","uniqueKey":"data.message","typeLabel":"string"},"configuration":{"type":"object","properties":{"client_id":{"type":"string","description":"The client identifier associated with the configuration.","uniqueKey":"data.configuration.client_id","typeLabel":"string"},"configuration_id":{"type":"string","format":"uuid","description":"The unique identifier for the configuration.","uniqueKey":"data.configuration.configuration_id","typeLabel":"string\u003cuuid>"},"tag":{"type":"string","description":"A descriptive name for the configuration. Permanent — cannot be changed after creation.","maxLength":255,"uniqueKey":"data.configuration.tag","typeLabel":"string"},"vocabulary":{"type":"array","items":{"type":"string","uniqueKey":"data.configuration.vocabulary.items.[INDEX]","typeLabel":"string"},"description":"Custom terms (brand names, acronyms, technical words) that improve transcription accuracy.","uniqueKey":"data.configuration.vocabulary","typeLabel":"string[]"},"extraction_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Field identifier. Auto-normalized on creation: lowercased, accents removed, special characters replaced with `_`. Example: `\"Customer ID\"` → `\"customer_id\"`.","maxLength":50,"isRequired":true,"uniqueKey":"data.configuration.extraction_fields.items.[INDEX].name","typeLabel":"string"},"type":{"type":"string","description":"Expected data type of the extracted value. **Immutable after creation.**","enum":["string","number","boolean","array"],"isRequired":true,"uniqueKey":"data.configuration.extraction_fields.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"Instructions for the AI on what to extract. The more specific, the better the accuracy. Example: `\"Classify the overall sentiment. Must be one of: POSITIVE, NEGATIVE, or NEUTRAL.\"`","maxLength":1000,"isRequired":true,"uniqueKey":"data.configuration.extraction_fields.items.[INDEX].description","typeLabel":"string"}},"additionalProperties":false,"required":["name","type","description"],"uniqueKey":"data.configuration.extraction_fields.items.[INDEX]","typeLabel":"object"},"description":"AI extraction field definitions (max 10).","uniqueKey":"data.configuration.extraction_fields","typeLabel":"object[]"},"webhooks":{"oneOf":[{"type":"object","description":"URLs for receiving completion/failure notifications via POST requests.","properties":{"success_url":{"type":"string","format":"uri","description":"Receives a POST request with the full transcription result on success.","uniqueKey":"data.configuration.webhooks.oneOf.0.success_url","typeLabel":"string\u003curi>"},"error_url":{"type":"string","format":"uri","description":"Receives a POST request with error details on failure.","uniqueKey":"data.configuration.webhooks.oneOf.0.error_url","typeLabel":"string\u003curi>"}},"additionalProperties":false,"uniqueKey":"data.configuration.webhooks.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.configuration.webhooks.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.configuration.webhooks","typeLabel":"object | null"},"summary":{"type":"boolean","description":"Whether to generate an AI summary.","uniqueKey":"data.configuration.summary","typeLabel":"boolean"},"custom_summary":{"oneOf":[{"type":"string","maxLength":300,"description":"Custom prompt guiding the AI summary. Only applies when `summary` is `true`.","uniqueKey":"data.configuration.custom_summary.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":300,"description":"Custom prompt guiding the AI summary. Only applies when `summary` is `true`.","uniqueKey":"data.configuration.custom_summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.configuration.custom_summary","typeLabel":"string | null"},"summary_language":{"type":"string","description":"Language for the summary. `\"df\"` = auto-detect.","uniqueKey":"data.configuration.summary_language","typeLabel":"string"},"analytics_language":{"type":"string","description":"Language for analytics reports. `\"df\"` = auto-detect.","uniqueKey":"data.configuration.analytics_language","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","description":"Timestamp of when the configuration was created (UTC).","uniqueKey":"data.configuration.created_at","typeLabel":"string\u003cdate-time>"}},"description":"The full updated configuration object.","uniqueKey":"data.configuration","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"UpdateSuccess":{"title":"UpdateSuccess","value":{"data":{"message":"Configuration updated successfully.","configuration":{"client_id":"client-12345","configuration_id":"a1b2c3d4-e5f6-7890-1234-567890abcdef","tag":"Customer Support - Technical Issues","vocabulary":["Heify","NLP"],"extraction_fields":[{"name":"sentiment_analysis","type":"string","description":"Classify the sentiment as POSITIVE, NEGATIVE, or NEUTRAL."}],"webhooks":null,"summary":true,"custom_summary":"Focus on key decisions and action items.","summary_language":"en","analytics_language":"df","created_at":"2025-01-15T10:00:00.000000+00:00"}}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"581956a4-2ed6-4337-9690-f86701ed1cf0":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]}}},"servers":{"81193391-b870-41d7-aa11-1febb5b8a0cc":{"url":"https://api.heify.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[]},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi-configurations.json"},"subdomain":"heify","siteName":"Heify Docs","title":"Update Configuration - Heify Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-22T19:00:11.256Z","originalFileLocation":"api-reference/configuration/update.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=\"Partially update an existing configuration. Only fields included in the request body are modified.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Heify 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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_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/heify/L0uPIXNiZtcgAM5I/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Configuration - Heify Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Partially update an existing configuration. Only fields included in the request body are modified.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Heify Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.heify.com/api-reference/configuration/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://heify.mintlify.app/_mintlify/api/og/v2?division=Configurations\u0026amp;title=Update+Configuration\u0026amp;description=Partially+update+an+existing+configuration.+Only+fields+included+in+the+request+body+are+modified.\u0026amp;theme=10435d334a6726ab229dc0b4\u0026amp;signature=41d1dd2a28e3591415eb6cb0448293a2b58aed53eed3f4db8251ca81a3827286\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Update Configuration - Heify Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Partially update an existing configuration. Only fields included in the request body are modified.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://heify.mintlify.app/_mintlify/api/og/v2?division=Configurations\u0026amp;title=Update+Configuration\u0026amp;description=Partially+update+an+existing+configuration.+Only+fields+included+in+the+request+body+are+modified.\u0026amp;theme=10435d334a6726ab229dc0b4\u0026amp;signature=41d1dd2a28e3591415eb6cb0448293a2b58aed53eed3f4db8251ca81a3827286\">\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/heify/L0uPIXNiZtcgAM5I/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Heify Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B82F6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.heify.com/api-reference/configuration/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/configuration/update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.heify.com/#organization\",\"name\":\"Heify Docs\",\"url\":\"https://docs.heify.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/heify/8fipfniSVMLrex-g/logo/light.svg?fit=max\u0026auto=format\u0026n=8fipfniSVMLrex-g\u0026q=85\u0026s=3239fc52dcd6309d024795459614038d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.heify.com#website\",\"name\":\"Heify Docs\",\"url\":\"https://docs.heify.com\",\"publisher\":{\"@id\":\"https://docs.heify.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.heify.com/api-reference/configuration/update#webpage\",\"url\":\"https://docs.heify.com/api-reference/configuration/update\",\"name\":\"Update Configuration\",\"description\":\"Partially update an existing configuration. Only fields included in the request body are modified.\",\"dateModified\":\"2026-03-22T19:00:11.256Z\",\"isPartOf\":{\"@id\":\"https://docs.heify.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.heify.com/api-reference/configuration/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.heify.com/api-reference/configuration/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Configurations\",\"item\":\"https://docs.heify.com/api-reference/configuration/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update Configuration\",\"item\":\"https://docs.heify.com/api-reference/configuration/update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.heify.com/api-reference/configuration/update#apireference\",\"headline\":\"Update Configuration\",\"name\":\"Update Configuration\",\"description\":\"Partially update an existing configuration. Only fields included in the request body are modified.\",\"url\":\"https://docs.heify.com/api-reference/configuration/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.heify.com/api-reference/configuration/update#webpage\"},\"dateModified\":\"2026-03-22T19:00:11.256Z\",\"publisher\":{\"@id\":\"https://docs.heify.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.heify.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Heify Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Heify Docs","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"https://sandbox.heify.com"},{"anchor":"Support","icon":"headset","href":"https://www.heify.com/contact.html"}]},"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Configurations","icon":"gear","pages":[{"title":"Create Configuration","openapi":"api-reference/openapi-configurations.json POST /create-configuration","href":"/api-reference/configuration/create"},{"title":"Get Configuration","openapi":"api-reference/openapi-configurations.json POST /get-configuration","href":"/api-reference/configuration/get"},{"title":"List Configurations","description":"Returns all configurations belonging to the authenticated client.","openapi":"api-reference/openapi-configurations.json POST /list-configurations","href":"/api-reference/configuration/list"},{"title":"Update Configuration","openapi":"api-reference/openapi-configurations.json POST /update-configuration","href":"/api-reference/configuration/update"},{"title":"Delete Configuration","openapi":"api-reference/openapi-configurations.json POST /delete-configuration","description":"Permanently deletes a specific configuration. This action is irreversible.","href":"/api-reference/configuration/delete"},{"title":"Configuration Analysis","openapi":"api-reference/openapi-configurations.json POST /analytics","href":"/api-reference/configuration/analytics"}]},{"group":"Evaluators","icon":"clipboard-check","pages":[{"title":"Create Evaluator","openapi":"api-reference/openapi-evaluators.json POST /create-evaluator","href":"/api-reference/evaluator/create"},{"title":"Get Evaluator","openapi":"api-reference/openapi-evaluators.json POST /get-evaluator","href":"/api-reference/evaluator/get"},{"title":"List Evaluators","openapi":"api-reference/openapi-evaluators.json POST /list-evaluators","href":"/api-reference/evaluator/list"},{"title":"Update Evaluator","openapi":"api-reference/openapi-evaluators.json POST /update-evaluator","href":"/api-reference/evaluator/update"},{"title":"Delete Evaluator","openapi":"api-reference/openapi-evaluators.json POST /delete-evaluator","href":"/api-reference/evaluator/delete"},{"title":"Evaluator Analysis","openapi":"api-reference/openapi-evaluators.json POST /analytics-evaluator","href":"/api-reference/evaluator/analytics"}]},{"group":"Participants","icon":"user","pages":[{"title":"Create Participant","openapi":"api-reference/openapi-participants.json POST /create-participant","href":"/api-reference/participant/create"},{"title":"List Participants","openapi":"api-reference/openapi-participants.json POST /list-participants","href":"/api-reference/participant/list"},{"title":"Update Participant","openapi":"api-reference/openapi-participants.json POST /update-participant","href":"/api-reference/participant/update"},{"title":"Delete Participant","openapi":"api-reference/openapi-participants.json POST /delete-participant","href":"/api-reference/participant/delete"},{"title":"Participant Analysis","openapi":"api-reference/openapi-participants.json POST /analytics-participant","href":"/api-reference/participant/analytics"}]},{"group":"Transcriptions","icon":"microphone","pages":[{"title":"Submit from public URL","openapi":"api-reference/openapi-transcriptions.json POST /submit","href":"/api-reference/transcription/submit"},{"title":"Submit from local file","openapi":"api-reference/openapi-transcriptions.json POST /request-upload-url","href":"/api-reference/transcription/request-upload-url"},{"title":"Get Transcription","openapi":"api-reference/openapi-transcriptions.json POST /get-transcription","href":"/api-reference/transcription/details"},{"title":"List Transcriptions","openapi":"api-reference/openapi-transcriptions.json POST /list-transcriptions","href":"/api-reference/transcription/list"},{"title":"Update Transcription Group","openapi":"api-reference/openapi-transcriptions.json POST /update-transcription-group","href":"/api-reference/transcription/update-group"},{"title":"Delete Transcription","openapi":"api-reference/openapi-transcriptions.json POST /delete-transcription","href":"/api-reference/transcription/delete"}]}]},{"tab":"Sandbox","icon":"flask","pages":[{"title":"Sandbox","href":"/sandbox"}]},{"tab":"Recorder","icon":"circle-dot","pages":[{"title":"Recorder","href":"/recorder"}]}]},"basePath":"","title":"Update Configuration - Heify Docs","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}