{ "slug": "ib-company-profile", "version": 1, "title": "Company Profile", "vertical": "investment-banking", "tags": [ "company-profile", "equities" ], "subtitle": "One-page profile of a public company.", "description": "Builds a company profile covering business, financials, and recent developments.", "popular": true, "recommended_mode": "heavy", "estimated_time": "10-20 min", "is_valyu": true, "owner_org_id": null, "variables": [ { "key": "company", "label": "Company name", "type": "text", "required": false, "placeholder": "NVIDIA (NVDA)", "help": "The company you want to profile.", "examples": [ "NVIDIA (NVDA)", "Microsoft (MSFT)" ], "validation": { "min_length": 1, "max_length": 2, "pattern": "<string>", "enum": [ "<string>" ] } } ], "deliverables": [ { "type": "xlsx", "description": "A model summary tab with revenue, margins, and key ratios." } ], "created_at": "2026-01-10T12:00:00Z", "updated_at": "2026-01-15T09:30:00Z", "prompt": "Build a company profile for {company} covering its business, financials, and recent developments.", "strategy": "<string>", "report_format": "<string>", "tools": { "code_execution": true, "screenshots": true, "browser_use": true, "charts": true }, "changelog": "<string>", "output_formats": [ { "type": "object", "properties": { "base_case": { "type": "string" }, "bull_case": { "type": "string" }, "bear_case": { "type": "string" }, "confidence": { "type": "number" } } }, "toon" ]}
BetaEdit an organization-owned workflow and publish a new immutable version. Supply the required changelog so users can understand what changed. Valyu-curated workflows are read-only.Use version pinning in production integrations when a template change should not silently change future runs. Test the new version on representative inputs before adopting it.
Edit an organization workflow. Metadata fields (title, subtitle, etc.) update in place. Supply a version object to publish a new immutable version - it requires a changelog. Valyu-curated workflows cannot be edited (cannot_edit_valyu_workflow).
When publishing a new version, whether to point the workflow's current (floating) version at it.
Example:
true
Response
New version published.
A single workflow returned as a flat object: the list-row fields plus the resolved version body (prompt, strategy, report_format, tools, changelog, output_formats). Returned by get, create (201), and update.
Output formats the workflow produces. Items are the strings "markdown", "pdf", or "toon", and/or a single JSON Schema object for structured output. Rules: at most one JSON Schema object; a JSON Schema object cannot be combined with "markdown" or "pdf"; "toon" requires a JSON Schema object. An invalid combination returns 400 invalid_output_formats.
At run time, a task created with workflow_id inherits the workflow's output_formats when the request does not pass its own; a request-level output_formats always wins.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Valyu","colors":{"primary":"#5E3454","light":"#C7E04A","dark":"#5E3454"},"logo":{"light":"https://mintcdn.com/valyu/XSNGAn-w-x47KJwH/logo/valyu-wordmark-light.svg?fit=max\u0026auto=format\u0026n=XSNGAn-w-x47KJwH\u0026q=85\u0026s=334dd47b5c8dd1f11877b78e19848e24","dark":"https://mintcdn.com/valyu/XSNGAn-w-x47KJwH/logo/valyu-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=XSNGAn-w-x47KJwH\u0026q=85\u0026s=0c6b3fd58f6d88e020a0ed506dfc7752"},"favicon":"https://mintcdn.com/valyu/ji-tdRNtRRe7QxMv/favicon.ico?fit=max\u0026auto=format\u0026n=ji-tdRNtRRe7QxMv\u0026q=85\u0026s=fef49c51724555d91437907a324be0a3","appearance":{"default":"light"},"background":{"color":{"light":"#FFFFFF","dark":"#141118"}},"navbar":{"links":[{"icon":"wave-pulse","href":"https://status.valyu.ai","label":"API status"},{"href":"/integrations/onboard-agents","label":"Connect your agents"}],"primary":{"type":"button","label":"Get an API key","href":"https://platform.valyu.ai/user/account/apikeys"}},"footer":{"socials":{"discord":"https://discord.gg/umtmSsppRY","x":"https://x.com/ValyuOfficial","github":"https://github.com/valyuAI","linkedin":"https://linkedin.com/company/valyu-ai"},"links":[{"header":"Product","items":[{"label":"Platform","href":"https://platform.valyu.ai"},{"label":"Data sources","href":"https://platform.valyu.ai/data-sources"},{"label":"Pricing","href":"https://docs.valyu.ai/pricing"}]},{"header":"Developers","items":[{"label":"API status","href":"https://status.valyu.ai"},{"label":"OpenAPI spec","href":"https://docs.valyu.ai/api-reference/openapi.json"},{"label":"Cookbook","href":"https://github.com/valyuAI/cookbook"},{"label":"All guides","href":"/guides"}]},{"header":"Company","items":[{"label":"valyu.ai","href":"https://www.valyu.ai"},{"label":"Blog","href":"https://valyu.ai/blog"},{"label":"Contact","href":"mailto:contact@valyu.ai"}]}]},"seo":{"metatags":{"viewport":"width=device-width, initial-scale=1.0","description":"Search API and agents for knowledge work.","og:type":"website","og:site_name":"Valyu","twitter:card":"summary_large_image","twitter:site":"@ValyuOfficial","twitter:creator":"@ValyuOfficial","robots":"index, follow","googlebot":"index, follow","author":"Valyu"},"organization":{"name":"Valyu","url":"https://www.valyu.ai","sameAs":["https://x.com/ValyuOfficial","https://linkedin.com/company/valyu-ai","https://github.com/valyuAI"]},"indexing":"all"},"fonts":{"family":"Schibsted Grotesk","weight":400},"styling":{"eyebrows":"breadcrumbs","latex":false},"integrations":{"posthog":{"apiKey":"phc_5WQIKDC13UTOCbh5VHAxwaDNzGL8wdmHfXON0ErVDxM","apiHost":"https://eu.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","add-mcp","cursor","vscode",{"title":"Open in Valyu","description":"Run this page as a query in Valyu DeepResearch","icon":"magnifying-glass","href":{"base":"https://platform.valyu.ai/playground/deepresearch","query":[{"key":"q","value":"$page"}]}},{"title":"Join our Discord","description":"Get help and discuss with the Valyu community","icon":"discord","href":"https://discord.gg/umtmSsppRY"}],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"valyu","hasAudioNarration":false,"actualSubdomain":"valyu","customDomains":["docs.valyu.ai"],"gitSource":{"type":"github","owner":"valyuai","repo":"valyu-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb408c57868d74937d22ce","collectionId":"4a18616c-4a37-4b61-a4e5-1065e8f97a5e","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb408c57868d74937d22ce"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{},"buildId":"6adb408c57868d74937d22ce","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"Documentation","count":83},{"language":"default","tag":"Build and connect","count":36},{"language":"default","tag":"API Reference","count":29},{"language":"default","tag":"SDKs","count":18},{"language":"default","tag":"Integrations","count":16},{"language":"default","tag":"DeepResearch","count":14},{"language":"default","tag":"APIs","count":13},{"language":"default","tag":"Start here","count":11},{"language":"default","tag":"Sciences workflows","count":10},{"language":"default","tag":"Finance workflows","count":10}]},"assistantConfig":{},"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":"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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gW8tenXg.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gf8tenXg.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gY8tenXg.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gU8tenXg.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gV8tenXg.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gb8tc.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gW8tenXg.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gf8tenXg.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gY8tenXg.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gU8tenXg.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gV8tenXg.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Source Serif 4';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/sourceserif4/v15/vEFI2_tTDB4M7-auWDN0ahZJW1gb8tc.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Spline Sans Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/splinesansmono/v13/R70BjzAei_CDNLfgZxrW6wrZOF2WX5yZmF2a.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Spline Sans Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/splinesansmono/v13/R70BjzAei_CDNLfgZxrW6wrZOF2WX5KZmA.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Spline Sans Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/splinesansmono/v13/R70BjzAei_CDNLfgZxrW6wrZOF2WX5yZmF2a.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Spline Sans Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/splinesansmono/v13/R70BjzAei_CDNLfgZxrW6wrZOF2WX5KZmA.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n@keyframes vx-dash{to{stroke-dashoffset:-24}}:root{--vx-ink:#17141A;--vx-body:#54525C;--vx-muted:#8C8A93;--vx-line:#E7E5EA;--vx-surface:#FBFAFB;--vx-wash:#F4F1F5;--vx-plum:#5E3454;--vx-plum-soft:#7D4A6F;--vx-lilac:#CBB1C4;--vx-citron:#C7E04A;--vx-citron-ink:#2C3400;--vx-display:\"Helvetica Now Display\", \"Helvetica Neue\", Helvetica, \"Schibsted Grotesk\", Arial, sans-serif;--vx-serif:\"Source Serif 4\", Georgia, serif;--vx-mono:\"Spline Sans Mono\", ui-monospace, SFMono-Regular, Menlo, monospace}.dark{--vx-ink:#F3F0F5;--vx-body:#B9B4BF;--vx-muted:#8E8995;--vx-line:#2D2832;--vx-surface:#1B171F;--vx-wash:#1E1A22;--vx-plum:#CBB1C4;--vx-plum-soft:#E2D2DE;--vx-lilac:#6E5468}::selection{background:var(--vx-citron);color:var(--vx-citron-ink)}#content-area :is(h1, h2, h3),#page-title{font-family:var(--vx-display);font-weight:500;letter-spacing:-.015em;color:var(--vx-ink)}#page-title{font-size:clamp(2rem,3.4vw,2.6rem);line-height:1.12;letter-spacing:-.022em}#content-area h2{letter-spacing:-.012em}#header .breadcrumb-item,.sidebar-group-header,.vx-label{font-family:var(--vx-mono);font-size:.72rem!important;font-weight:400;letter-spacing:.02em;text-transform:none}.sidebar-group-header{color:var(--vx-muted)!important}#content-area code:not(pre code){font-size:.86em}.nav-tabs-item .bg-primary,.nav-tabs-item .dark\\:bg-primary-light{background:var(--vx-citron)!important}.nav-tabs-item:hover>[class*=group-hover]{background:var(--vx-plum-soft)!important}.callout,.nav-tabs-item,[class*=rounded-2xl]:not([class*=navbar-primary]):not([class*=pill]),[class*=rounded-lg]:not([class*=navbar-primary]):not([class*=pill]),[class*=rounded-md],[class*=rounded-sm],[class*=rounded-xl]:not([class*=navbar-primary]):not([class*=pill]),button:not([class*=pill]):not([class*=rounded-full]),code,input[type=text],pre{border-radius:0!important}[class*=navbar-primary] a,[class*=navbar-primary] button{border-radius:0!important}a[class*=rounded-full],button[class*=rounded-full]{border-radius:9999px!important}img.nav-logo{height:17px!important}#sidebar{border-right:1px solid var(--vx-line)}#sidebar-content{padding-right:1rem}#sidebar a[aria-current=page]{box-shadow:inset 2px 0 var(--vx-citron)}#header{position:relative;padding-bottom:1.25rem;border-bottom:1px solid var(--vx-line)}#header::after,.vx-node::after{content:\"\";position:absolute;background:var(--vx-citron)}#header::after{bottom:-1px;left:0;width:40px;height:2px}#content-area .card{border-color:var(--vx-line);transition:border-color .15s ease,background-color .15s ease}#content-area .card:hover{border-color:var(--vx-plum-soft);background:var(--vx-surface)}#content-area table th,.vx-source span{font-family:var(--vx-mono);color:var(--vx-muted)}#content-area table th{font-size:.72rem;font-weight:500;letter-spacing:.02em}.vx-panel,.vx-query{border:1px solid var(--vx-line)}.vx-panel{position:relative;overflow:hidden;margin:1.75rem 0 2rem;padding:1.5rem;background:radial-gradient(120% 90% at 0% 0%,rgba(203,177,196,.28),transparent 60%),radial-gradient(90% 80% at 100% 100%,rgba(199,224,74,.2),transparent 62%),var(--vx-surface)}.dark .vx-panel{background:radial-gradient(120% 90% at 0% 0%,rgba(126,84,115,.22),transparent 60%),radial-gradient(90% 80% at 100% 100%,rgba(199,224,74,.07),transparent 62%),var(--vx-surface)}.vx-query{display:flex;align-items:center;gap:.75rem;padding:.85rem 1rem;background:rgba(255,255,255,.72);font-family:var(--vx-serif);font-size:1.05rem;color:var(--vx-ink)}.dark .vx-query{background:rgba(20,17,24,.6)}.vx-query svg,.vx-source svg{flex:0 0 18px;width:18px;height:18px;color:var(--vx-muted)}.vx-flow{display:grid;grid-template-columns:minmax(0,1fr) 44px 112px 44px minmax(0,1.08fr);height:288px;margin-top:1.25rem}.vx-stack{display:grid;gap:8px;min-width:0}.vx-sources{grid-template-rows:18px repeat(4,minmax(0,1fr))}.vx-outputs{grid-template-rows:repeat(2,minmax(0,1fr));gap:12px}.vx-stack>.vx-label{align-self:end;line-height:1;color:var(--vx-muted)}.vx-source{display:flex;min-width:0;align-items:center;gap:.7rem;padding:.6rem .75rem;border:1px solid var(--vx-line);background:#fff}.dark .vx-output,.dark .vx-source{background:#17141b}.vx-source svg{color:var(--vx-plum)}.vx-source strong{display:block;font-size:.84rem;font-weight:500;line-height:1.3;color:var(--vx-ink)}.vx-source span{display:block;font-size:.66rem;line-height:1.4}.vx-wires{width:100%;height:100%;color:var(--vx-lilac);overflow:visible}.vx-wires path{fill:none;stroke:currentColor;stroke-width:1;vector-effect:non-scaling-stroke}.vx-wires path.vx-live{stroke:var(--vx-citron);stroke-width:1.5;stroke-dasharray:4 8;animation:vx-dash 1.6s linear infinite}.vx-node,.vx-output{display:flex;flex-direction:column;justify-content:center}.vx-node{position:relative;align-items:center;align-self:center;gap:.55rem;width:112px;height:112px;background:#17141a;color:#fff;box-shadow:0 18px 40px -22px rgba(23,20,26,.55)}.vx-node::after{top:10px;right:10px;width:5px;height:5px}.vx-node svg{width:34px;height:34px}.vx-node span,.vx-output b{font-family:var(--vx-serif);font-size:1.15rem;line-height:1}.dark .vx-node{background:#000;outline:1px solid var(--vx-line)}.vx-output{min-width:0;padding:1rem 1.1rem;border:1px solid var(--vx-line);background:#fff;color:inherit;text-decoration:none!important;border-bottom-width:1px!important;border-bottom-color:var(--vx-line)!important;transition:border-color .15s ease}.vx-output:hover{border-color:var(--vx-plum-soft)!important}.vx-output .vx-label{color:var(--vx-muted)}.vx-output b{display:block;margin:.3rem 0 .25rem;font-size:1.35rem;font-weight:400;line-height:1.15;color:var(--vx-plum)}.vx-output p{margin:0;font-size:.86rem;line-height:1.5;color:var(--vx-body)}.prose td{font-variant-numeric:normal}.vx-cr{white-space:nowrap}.vx-cr::before{content:\"\";display:inline-block;width:1em;height:1em;margin-right:.3em;vertical-align:-.15em;background-color:var(--vx-plum);-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 256 256'%3E%3Cpath d='M240,132c0,19.88-35.82,36-80,36-19.6,0-37.56-3.17-51.47-8.44h0C146.76,156.85,176,142,176,124V96.72h0C212.52,100.06,240,114.58,240,132ZM176,84c0-19.88-35.82-36-80-36S16,64.12,16,84s35.82,36,80,36S176,103.88,176,84Z' opacity='0.2'/%3E%3Cpath d='M184,89.57V84c0-25.08-37.83-44-88-44S8,58.92,8,84v40c0,20.89,26.25,37.49,64,42.46V172c0,25.08,37.83,44,88,44s88-18.92,88-44V132C248,111.3,222.58,94.68,184,89.57ZM232,132c0,13.22-30.79,28-72,28-3.73,0-7.43-.13-11.08-.37C170.49,151.77,184,139,184,124V105.74C213.87,110.19,232,122.27,232,132ZM72,150.25V126.46A183.74,183.74,0,0,0,96,128a183.74,183.74,0,0,0,24-1.54v23.79A163,163,0,0,1,96,152,163,163,0,0,1,72,150.25Zm96-40.32V124c0,8.39-12.41,17.4-32,22.87V123.5C148.91,120.37,159.84,115.71,168,109.93ZM96,56c41.21,0,72,14.78,72,28s-30.79,28-72,28S24,97.22,24,84,54.79,56,96,56ZM24,124V109.93c8.16,5.78,19.09,10.44,32,13.57v23.37C36.41,141.4,24,132.39,24,124Zm64,48v-4.17c2.63.1,5.29.17,8,.17,3.88,0,7.67-.13,11.39-.35A121.92,121.92,0,0,0,120,171.41v23.46C100.41,189.4,88,180.39,88,172Zm48,26.25V174.4a179.48,179.48,0,0,0,24,1.6,183.74,183.74,0,0,0,24-1.54v23.79a165.45,165.45,0,0,1-48,0Zm64-3.38V171.5c12.91-3.13,23.84-7.79,32-13.57V172C232,180.39,219.59,189.4,200,194.87Z'/%3E%3C/svg%3E\") center/contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 256 256'%3E%3Cpath d='M240,132c0,19.88-35.82,36-80,36-19.6,0-37.56-3.17-51.47-8.44h0C146.76,156.85,176,142,176,124V96.72h0C212.52,100.06,240,114.58,240,132ZM176,84c0-19.88-35.82-36-80-36S16,64.12,16,84s35.82,36,80,36S176,103.88,176,84Z' opacity='0.2'/%3E%3Cpath d='M184,89.57V84c0-25.08-37.83-44-88-44S8,58.92,8,84v40c0,20.89,26.25,37.49,64,42.46V172c0,25.08,37.83,44,88,44s88-18.92,88-44V132C248,111.3,222.58,94.68,184,89.57ZM232,132c0,13.22-30.79,28-72,28-3.73,0-7.43-.13-11.08-.37C170.49,151.77,184,139,184,124V105.74C213.87,110.19,232,122.27,232,132ZM72,150.25V126.46A183.74,183.74,0,0,0,96,128a183.74,183.74,0,0,0,24-1.54v23.79A163,163,0,0,1,96,152,163,163,0,0,1,72,150.25Zm96-40.32V124c0,8.39-12.41,17.4-32,22.87V123.5C148.91,120.37,159.84,115.71,168,109.93ZM96,56c41.21,0,72,14.78,72,28s-30.79,28-72,28S24,97.22,24,84,54.79,56,96,56ZM24,124V109.93c8.16,5.78,19.09,10.44,32,13.57v23.37C36.41,141.4,24,132.39,24,124Zm64,48v-4.17c2.63.1,5.29.17,8,.17,3.88,0,7.67-.13,11.39-.35A121.92,121.92,0,0,0,120,171.41v23.46C100.41,189.4,88,180.39,88,172Zm48,26.25V174.4a179.48,179.48,0,0,0,24,1.6,183.74,183.74,0,0,0,24-1.54v23.79a165.45,165.45,0,0,1-48,0Zm64-3.38V171.5c12.91-3.13,23.84-7.79,32-13.57V172C232,180.39,219.59,189.4,200,194.87Z'/%3E%3C/svg%3E\") center/contain no-repeat}.vx-stat-row{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1px;background:var(--vx-line);border:1px solid var(--vx-line);margin:1.5rem 0 2rem}.vx-stat{padding:1rem 1.1rem;background:#fff}.dark .vx-stat{background:#141118}.vx-stat .vx-label,.vx-stat b{display:block;color:var(--vx-muted)}.vx-stat b{margin-top:.35rem;font-family:var(--vx-display);font-size:1.6rem;font-weight:500;letter-spacing:-.02em;line-height:1.1;color:var(--vx-ink);font-variant-numeric:tabular-nums}.vx-stat b.vx-cr::before{width:.8em;height:.8em;margin-right:.2em;vertical-align:-.06em}.vx-stat span:not(.vx-label){display:block;margin-top:.3rem;font-size:.8rem;color:var(--vx-body)}.vx-mark{background:var(--vx-citron);color:var(--vx-citron-ink);padding:0 .12em;box-decoration-break:clone;-webkit-box-decoration-break:clone}.vx-plans{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1px;background:var(--vx-line);border:1px solid var(--vx-line);margin:1.5rem 0 1rem}.vx-plan{position:relative;display:flex;flex-direction:column;padding:1.25rem 1.35rem;background:#fff}.dark .vx-plan{background:#141118}.vx-plan .vx-label{color:var(--vx-muted)}.vx-plan .vx-plan-name{margin:.45rem 0 0;font-family:var(--vx-serif);font-size:1.3rem;line-height:1.2;color:var(--vx-plum)}.vx-plan .vx-price{margin:.85rem 0 .15rem;font-family:var(--vx-display);font-size:2rem;font-weight:500;letter-spacing:-.025em;line-height:1;color:var(--vx-ink);font-variant-numeric:tabular-nums}.vx-plan .vx-price small{font-family:inherit;font-size:.8rem;font-weight:400;letter-spacing:0;color:var(--vx-muted)}.vx-plan .vx-includes,.vx-plan li{margin:.5rem 0 .9rem;font-size:.86rem;color:var(--vx-body)}.vx-plan .vx-includes strong{color:var(--vx-ink);font-weight:500}.vx-plan ul{margin:auto 0 0;padding:.85rem 0 0;border-top:1px solid var(--vx-line);list-style:none}.vx-plan li{position:relative;margin:0 0 .35rem;padding-left:1rem;font-size:.8rem;line-height:1.45}.vx-plan li::before{content:\"\";position:absolute;left:0;top:.5em;width:5px;height:5px;background:var(--vx-lilac)}.vx-plans .vx-plan-featured{background:var(--vx-surface);box-shadow:inset 0 2px 0 var(--vx-citron)}.vx-badge{display:inline-block;margin-left:.4rem;padding:.05rem .35rem;background:var(--vx-citron);color:var(--vx-citron-ink);font-family:var(--vx-mono);font-size:.62rem;letter-spacing:.02em;vertical-align:.15em}.vx-wf-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1px;background:var(--vx-line);border:1px solid var(--vx-line);margin:1.25rem 0 2.25rem}.vx-wf{display:flex;flex-direction:column;padding:1.1rem 1.25rem 1.15rem;background:#fff;text-decoration:none;transition:background-color .15s ease}.dark .vx-wf{background:#141118}.vx-wf:hover{background:var(--vx-surface)}.vx-report:last-child:nth-child(odd),.vx-wf:last-child:nth-child(odd){grid-column:1/-1}.vx-wf .vx-label{color:var(--vx-muted)}.vx-wf strong{margin-top:.4rem;font-family:var(--vx-serif);font-size:1.15rem;font-weight:400;line-height:1.25;color:var(--vx-plum)}.vx-wf strong::after{content:\"→\";display:inline-block;margin-left:.35em;font-family:var(--vx-display);font-size:.9em;transition:transform .15s ease}.vx-wf:hover strong::after{transform:translateX(3px)}.vx-wf-desc{margin-top:.35rem;font-size:.84rem;line-height:1.5;color:var(--vx-body)}.vx-wf-ex{margin-top:auto;padding-top:.8rem;font-family:var(--vx-mono);font-size:.68rem;letter-spacing:.01em;color:var(--vx-muted)}.vx-wf-ex:not(.vx-wf-meta)::before{content:\"e.g. \"}.vx-reports{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1px;background:var(--vx-line);border:1px solid var(--vx-line);margin:1.25rem 0 2.25rem}.vx-report{display:flex;flex-direction:column;padding:1.15rem 1.25rem 1.1rem;background:#fff}.dark .vx-report{background:#141118}.vx-report .vx-label{color:var(--vx-muted)}.vx-report h3{margin:.4rem 0 0!important;font-family:var(--vx-serif)!important;font-size:1.15rem!important;font-weight:400!important;letter-spacing:0!important;line-height:1.25;color:var(--vx-plum)!important}.vx-report p{margin:.4rem 0 0;font-size:.84rem;line-height:1.5;color:var(--vx-body)}.vx-report-meta{display:flex;flex-wrap:wrap;gap:.35rem;margin-top:.75rem}.vx-report-meta span{padding:.1rem .4rem;border:1px solid var(--vx-line);font-family:var(--vx-mono);font-size:.66rem;color:var(--vx-body)}.vx-report-meta .vx-mode{background:var(--vx-citron);border-color:var(--vx-citron);color:var(--vx-citron-ink)}.vx-report-links{display:flex;flex-wrap:wrap;gap:.9rem;margin-top:auto;padding-top:.9rem;font-size:.8rem}.vx-report-links a{color:var(--vx-plum);font-weight:500;text-decoration:none;border-bottom:1px solid var(--vx-lilac)}.vx-report-links a:hover{border-bottom-color:var(--vx-plum)}.vx-report-links a:first-child::after{content:\" →\"}@media (max-width:640px){.vx-plans,.vx-reports,.vx-stat-row,.vx-wf-grid{grid-template-columns:1fr}}@media (max-width:900px){.vx-flow{grid-template-columns:1fr;gap:1rem;height:auto}.vx-outputs,.vx-sources{grid-template-rows:none}.vx-wires{display:none}.vx-node{width:100%;height:auto;flex-direction:row;padding:.9rem}.vx-node svg{width:22px;height:22px}}@media (prefers-reduced-motion:reduce){.vx-wires path.vx-live{animation:none}#content-area .card,.vx-output,.vx-wf,.vx-wf strong::after{transition:none}}:is(nav[aria-label=\"Main\"], .navbar-link) a[href=\"/integrations/onboard-agents\"]::after{content:\"\";width:63px;height:18px;flex-shrink:0;margin-left:3px;background:url(/icons/agent-marks-light.svg) center/contain no-repeat}.dark :is(nav[aria-label=\"Main\"], .navbar-link) a[href=\"/integrations/onboard-agents\"]::after{background-image:url(/icons/agent-marks-dark.svg)}:is(nav[aria-label=\"Main\"], .navbar-link) a:focus-visible{outline:2px solid var(--vx-plum-soft);outline-offset:5px}#content-area a:focus-visible{outline:2px solid var(--vx-plum-soft);outline-offset:3px}.agent-deeplinks{display:flex;flex-wrap:wrap;gap:.5rem;margin:1.25rem 0 1.5rem}.agent-deeplink{display:inline-flex;align-items:center;gap:.5rem;padding:.8rem 1.15rem;border:1px solid rgba(60,31,53,.16);background:#fff;font-size:.9375rem;font-weight:600;color:#17141a;text-decoration:none;white-space:nowrap;cursor:pointer;transition:border-color .15s ease,background .15s ease,transform .15s ease,box-shadow .15s ease}.agent-deeplink:hover{border-color:#9a6e8f;background:rgba(154,110,143,.05);color:#17141a;text-decoration:none;transform:translateY(-1px);box-shadow:0 6px 16px -8px rgba(23,20,26,.28)}.agent-mark{width:22px;height:22px;flex-shrink:0}.agent-arrow{font-size:.8125rem;opacity:.35;transition:opacity .15s ease,transform .15s ease}.agent-deeplink:hover .agent-arrow{opacity:.85;transform:translate(1px,-1px)}.agent-deeplink-plain{border-style:dashed;font-weight:500;color:#6b6570}.dark .agent-deeplink{border-color:rgba(255,255,255,.14);background:rgba(255,255,255,.03);color:#e6dce3}.dark .agent-deeplink:hover{border-color:#cbb1c4;background:rgba(203,177,196,.1);color:#fff}.dark .agent-mark-mono{fill:#fff}.dark #sidebar-content img[src$=\".png\"],.dark img[src$=\"/icons/mcp.svg\"]{filter:invert(1)}.dark .agent-deeplink-plain{color:#a9a2ae}.docs-sidebar-cta{--cta-background:#2A1524;--cta-border:rgba(255, 255, 255, 0.14);--cta-text:#FFFFFF;--cta-muted:#D8C6D3;margin-top:24px!important;padding:20px;border:1px solid var(--cta-border);border-radius:12px;background:var(--cta-background);color:var(--cta-text);font-size:14px;line-height:1.5}.docs-sidebar-cta-logo{display:block;width:100px;height:auto;margin-bottom:20px}.docs-sidebar-cta-title{margin:0 0 8px;color:var(--cta-text);font-size:20px;font-weight:600;letter-spacing:-.4px;line-height:1.3}.docs-sidebar-cta-credits,.docs-sidebar-cta-description{margin:0 0 16px;color:var(--cta-muted)}.docs-sidebar-cta-primary{font-weight:600}.docs-sidebar-cta-primary,.docs-sidebar-cta-secondary{display:flex;align-items:center;justify-content:center;position:relative;min-height:44px;padding:10px 32px;border:1px solid transparent;border-radius:6px;line-height:1.5;text-decoration:none;transition:background-color 150ms,border-color 150ms}.docs-sidebar-cta-primary{background:#c7e04a;color:#2c3400}.docs-sidebar-cta-primary:hover{background:#d6ec73;color:#2c3400}.docs-sidebar-cta-secondary{margin-top:8px;border-color:var(--cta-border);background:0 0;color:var(--cta-text);font-weight:500}.docs-sidebar-cta-secondary:hover{border-color:rgba(255,255,255,.4);background:#3c1f35;color:var(--cta-text)}.docs-sidebar-cta-primary span,.docs-sidebar-cta-secondary span{position:absolute;right:14px;font-size:16px}.docs-sidebar-cta a:focus-visible{outline:2px solid #c7e04a;outline-offset:3px}.docs-sidebar-cta-note{margin:12px 0 0;color:var(--cta-muted);font-size:12px;text-align:center}@media (prefers-reduced-motion:reduce){.docs-sidebar-cta a{transition:none}}#footer>div{padding-top:2.5rem!important;padding-bottom:1.75rem!important;gap:1.75rem!important}#footer .flex-col.gap-4{gap:.6rem!important}.vx-report .vx-report-finding{margin-top:.7rem;padding:.55rem .7rem;background:var(--vx-wash);font-size:.8rem;color:var(--vx-ink)}.vx-report .vx-report-finding .vx-label{display:block;margin-bottom:.15rem}.vx-report .vx-report-note{margin-top:.5rem;font-size:.74rem;color:var(--vx-muted)}"}],"page":{"pagePath":"api-reference/endpoint/workflows-update","slug":"/api-reference/endpoint/workflows-update","pageMetadata":{"title":"Update Workflow","description":"Edit a custom org Workflow, creating a new version with a changelog.","og:title":"Workflows - Update | Valyu","og:description":"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.","twitter:title":"Workflows - Update | Valyu","twitter:description":"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.","keywords":"Valyu, Workflows, DeepResearch, versioning, changelog","openapi":"PATCH /v1/workflows/{slug}","href":"/api-reference/endpoint/workflows-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: \"Edit a custom org Workflow, creating a new version with a changelog.\"\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={p:`p`,..._provideComponents(),...props.components},{Badge}=_components;if(!Badge)_missingMdxReference(`Badge`,true);return _jsxs(_Fragment,{children:[_jsx(Badge,{children:`Beta`}),`\n`,_jsx(_components.p,{children:`Edit an organization-owned workflow and publish a new immutable version. Supply the required changelog so users can understand what changed. Valyu-curated workflows are read-only.`}),`\n`,_jsx(_components.p,{children:`Use version pinning in production integrations when a template change should not silently change future runs. Test the new version on representative inputs before adopting it.`})]})}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 Workflow","description":"Edit a custom org Workflow, creating a new version with a changelog.","og:title":"Workflows - Update | Valyu","og:description":"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.","twitter:title":"Workflows - Update | Valyu","twitter:description":"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.","keywords":"Valyu, Workflows, DeepResearch, versioning, changelog","openapi":"PATCH /v1/workflows/{slug}","href":"/api-reference/endpoint/workflows-update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/valyu/36f18cbaf7d4191d/custom.js","/_mintlify/custom/valyu/de07148e46689f3a/cta-attribution.js"],"openApiReferenceData":{"operation":{"operationId":"updateWorkflow","summary":"Edit a workflow / publish a new version (Beta)","description":"Edit a custom org Workflow, creating a new version with a changelog.","tags":["Workflows"],"parameters":["cc0e53cc-7587-4700-b085-72259b15b4a6"],"requestBody":"4891216b-3766-4036-b2ec-b89d85d14126","responses":{"200":"ffb79933-c2c3-4e35-80f3-9fa9f7b9a89e","400":"18476da6-1d03-4e80-986b-ec390476a431","401":"4f0e84ef-822f-4b44-8cc9-551f5205923d","403":"116aaba5-0e03-46d5-84c2-1abdb98088cd","404":"cc03cb5d-23b7-42da-a274-bb6da3503abe","500":"5ff220ec-ee4d-4655-b3ee-d9010fd601bf"},"method":"patch","type":"path","servers":["4ec95c84-073b-4972-924a-67bee24f05ec"],"security":["94d79a2e-4187-471a-9be9-391d4fe3e7f6"],"path":"/v1/workflows/{slug}","baseUrlOptions":["https://api.valyu.ai"],"title":"Edit a workflow / publish a new version (Beta)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"cc0e53cc-7587-4700-b085-72259b15b4a6":{"name":"slug","in":"path","required":true,"schema":{"type":"string","isRequired":true,"description":"The workflow slug.","uniqueKey":"","typeLabel":"string"},"description":"The workflow slug.","example":"ib-company-profile"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Edit an organization workflow. Metadata fields (title, subtitle, etc.) update in place. Supply a `version` object to publish a new immutable version - it requires a `changelog`. Valyu-curated workflows cannot be edited (`cannot_edit_valyu_workflow`).","properties":{"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"subtitle":{"type":"string","uniqueKey":"subtitle","typeLabel":"string"},"description":{"type":"string","uniqueKey":"description","typeLabel":"string"},"vertical":{"type":"string","uniqueKey":"vertical","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"maxItems":20,"uniqueKey":"tags","typeLabel":"string[]"},"icon":{"type":"string","uniqueKey":"icon","typeLabel":"string"},"version":{"type":"object","description":"A new version body to publish. Requires `changelog` (`changelog_required` otherwise).","required":["prompt","strategy","report_format"],"properties":{"prompt":{"type":"string","description":"Prompt template with `{key}` placeholders. Up to 64 KB.","example":"Build a company profile for {company} covering its business, financials, and recent developments.","isRequired":true,"uniqueKey":"version.prompt","typeLabel":"string"},"strategy":{"type":"string","description":"Research strategy. Maps to DeepResearch `research_strategy`. Up to 64 KB.","example":"Prioritise the latest 10-K/10-Q, investor relations materials, and reputable news.","isRequired":true,"uniqueKey":"version.strategy","typeLabel":"string"},"report_format":{"type":"string","description":"Report format instructions. Maps to DeepResearch `report_format`. Up to 64 KB.","example":"A one-page profile with business overview, key financials, and recent developments.","isRequired":true,"uniqueKey":"version.report_format","typeLabel":"string"},"variables":{"type":"array","description":"Typed template variables. Up to 50.","items":{"type":"object","description":"A typed variable referenced by `{key}` placeholders in the workflow prompt template.","required":["key","label"],"properties":{"key":{"type":"string","description":"Unique key for the variable. Used as the `{key}` placeholder in the template and as the field name in `workflow_params`.","example":"company","isRequired":true,"uniqueKey":"version.variables.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Human-readable label for the variable.","example":"Company name","isRequired":true,"uniqueKey":"version.variables.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","description":"Input type for a workflow template variable. Controls how the variable is rendered and validated.","enum":["text","textarea","number","date","enum"],"example":"text","uniqueKey":"version.variables.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"required":{"type":"boolean","description":"Whether a value must be supplied for this variable.","default":false,"uniqueKey":"version.variables.items.[INDEX].required","typeLabel":"boolean"},"placeholder":{"type":"string","description":"Placeholder text shown in the input field.","example":"NVIDIA (NVDA)","uniqueKey":"version.variables.items.[INDEX].placeholder","typeLabel":"string"},"help":{"type":"string","description":"Help text explaining what to enter.","example":"The company you want to profile.","uniqueKey":"version.variables.items.[INDEX].help","typeLabel":"string"},"examples":{"type":"array","description":"Example values for the variable.","items":{"type":"string","uniqueKey":"version.variables.items.[INDEX].examples.items.[INDEX]","typeLabel":"string"},"example":["NVIDIA (NVDA)","Microsoft (MSFT)"],"uniqueKey":"version.variables.items.[INDEX].examples","typeLabel":"string[]"},"validation":{"type":"object","description":"Validation rules applied to the variable's value.","properties":{"min_length":{"type":"integer","description":"Minimum string length.","minimum":0,"uniqueKey":"version.variables.items.[INDEX].validation.min_length","typeLabel":"integer"},"max_length":{"type":"integer","description":"Maximum string length.","minimum":1,"uniqueKey":"version.variables.items.[INDEX].validation.max_length","typeLabel":"integer"},"pattern":{"type":"string","description":"Regular expression the value must match.","uniqueKey":"version.variables.items.[INDEX].validation.pattern","typeLabel":"string"},"enum":{"type":"array","description":"Allowed values when `type` is `enum`.","items":{"type":"string","uniqueKey":"version.variables.items.[INDEX].validation.enum.items.[INDEX]","typeLabel":"string"},"uniqueKey":"version.variables.items.[INDEX].validation.enum","typeLabel":"string[]"}},"uniqueKey":"version.variables.items.[INDEX].validation","typeLabel":"object"}},"uniqueKey":"version.variables.items.[INDEX]","typeLabel":"object"},"maxItems":50,"uniqueKey":"version.variables","typeLabel":"object[]"},"deliverables":{"type":"array","description":"Deliverables produced by the workflow. Up to 20.","items":{"type":"object","description":"A deliverable file the workflow produces.","required":["type","description"],"properties":{"type":{"type":"string","description":"File format for the deliverable.","enum":["csv","xlsx","pptx","docx","pdf"],"example":"xlsx","isRequired":true,"uniqueKey":"version.deliverables.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"What the deliverable should contain.","example":"A model summary tab with revenue, margins, and key ratios.","isRequired":true,"uniqueKey":"version.deliverables.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"version.deliverables.items.[INDEX]","typeLabel":"object"},"maxItems":20,"uniqueKey":"version.deliverables","typeLabel":"object[]"},"tools":{"type":"object","description":"Optional tools the workflow's research agent may use.","properties":{"code_execution":{"type":"boolean","description":"Enable code execution in a sandboxed environment.","uniqueKey":"version.tools.code_execution","typeLabel":"boolean"},"screenshots":{"type":"boolean","description":"Enable visual screenshot capture of web pages.","uniqueKey":"version.tools.screenshots","typeLabel":"boolean"},"browser_use":{"type":"boolean","description":"Enable autonomous browser sessions.","uniqueKey":"version.tools.browser_use","typeLabel":"boolean"},"charts":{"type":"boolean","description":"Enable chart and graph generation in the report.","uniqueKey":"version.tools.charts","typeLabel":"boolean"}},"uniqueKey":"version.tools","typeLabel":"object"},"recommended_mode":{"type":"string","description":"Recommended DeepResearch mode for a workflow. Maps directly to the DeepResearch `mode` parameter.","enum":["fast","standard","heavy","max"],"example":"heavy","uniqueKey":"version.recommended_mode","typeLabel":"enum\u003cstring>"},"estimated_time":{"type":"string","example":"10-20 min","uniqueKey":"version.estimated_time","typeLabel":"string"},"output_formats":{"type":"array","description":"Output formats the workflow produces. Items are the strings `\"markdown\"`, `\"pdf\"`, or `\"toon\"`, and/or a single JSON Schema object for structured output. Rules: at most one JSON Schema object; a JSON Schema object cannot be combined with `\"markdown\"` or `\"pdf\"`; `\"toon\"` requires a JSON Schema object. An invalid combination returns `400 invalid_output_formats`.\n\nAt run time, a task created with `workflow_id` inherits the workflow's `output_formats` when the request does not pass its own; a request-level `output_formats` always wins.","items":{"oneOf":[{"type":"string","enum":["markdown","pdf","toon"],"uniqueKey":"version.output_formats.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"JSON Schema for structured output.","uniqueKey":"version.output_formats.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"version.output_formats.items.[INDEX]","typeLabel":"enum\u003cstring> | object"},"example":[{"type":"object","properties":{"base_case":{"type":"string"},"bull_case":{"type":"string"},"bear_case":{"type":"string"},"confidence":{"type":"number"}}},"toon"],"uniqueKey":"version.output_formats","typeLabel":"(enum\u003cstring> | object)[]"},"changelog":{"type":"string","description":"Notes describing what changed. Required when publishing a new version on update.","example":"Added a competitive landscape section.","uniqueKey":"version.changelog","typeLabel":"string"}},"uniqueKey":"version","typeLabel":"object"},"set_current":{"type":"boolean","description":"When publishing a new version, whether to point the workflow's current (floating) version at it.","example":true,"uniqueKey":"set_current","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"title":"\u003cstring>","subtitle":"\u003cstring>","description":"\u003cstring>","vertical":"\u003cstring>","tags":["\u003cstring>"],"icon":"\u003cstring>","set_current":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ffb79933-c2c3-4e35-80f3-9fa9f7b9a89e":{"description":"New version published.","content":{"application/json":{"schema":{"type":"object","description":"A single workflow returned as a flat object: the list-row fields plus the resolved version body (`prompt`, `strategy`, `report_format`, `tools`, `changelog`, `output_formats`). Returned by get, create (`201`), and update.","required":["slug","title","version"],"properties":{"slug":{"type":"string","description":"Unique slug identifying the workflow within its scope. Used as `workflow_id` when running.","example":"ib-company-profile","isRequired":true,"uniqueKey":"slug","typeLabel":"string"},"version":{"type":"integer","description":"The current (floating) published version number.","minimum":1,"example":1,"isRequired":true,"uniqueKey":"version","typeLabel":"integer"},"title":{"type":"string","description":"Display title.","example":"Company Profile","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"vertical":{"oneOf":[{"type":"string","description":"Vertical the workflow targets (e.g. `investment-banking`, `private-equity`, `hedge-funds`, `consulting`, `life-sciences`, `legal-regulatory`, `sales-intelligence`, `supply-chain`).","example":"investment-banking","uniqueKey":"vertical.oneOf.0","typeLabel":"string"},{"type":"null","description":"Vertical the workflow targets (e.g. `investment-banking`, `private-equity`, `hedge-funds`, `consulting`, `life-sciences`, `legal-regulatory`, `sales-intelligence`, `supply-chain`).","example":"investment-banking","uniqueKey":"vertical.oneOf.1","typeLabel":"null"}],"uniqueKey":"vertical","typeLabel":"string | null"},"tags":{"type":"array","description":"Tags for discovery. Up to 20.","items":{"type":"string","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"maxItems":20,"example":["company-profile","equities"],"uniqueKey":"tags","typeLabel":"string[]"},"subtitle":{"oneOf":[{"type":"string","description":"Short subtitle.","example":"One-page profile of a public company.","uniqueKey":"subtitle.oneOf.0","typeLabel":"string"},{"type":"null","description":"Short subtitle.","example":"One-page profile of a public company.","uniqueKey":"subtitle.oneOf.1","typeLabel":"null"}],"uniqueKey":"subtitle","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Longer description of what the workflow does.","example":"Builds a company profile covering business, financials, and recent developments.","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Longer description of what the workflow does.","example":"Builds a company profile covering business, financials, and recent developments.","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"popular":{"type":"boolean","description":"Whether the workflow is flagged as popular.","example":true,"uniqueKey":"popular","typeLabel":"boolean"},"recommended_mode":{"type":"string","description":"Recommended DeepResearch mode for a workflow. Maps directly to the DeepResearch `mode` parameter.","enum":["fast","standard","heavy","max"],"example":"heavy","uniqueKey":"recommended_mode","typeLabel":"enum\u003cstring>"},"estimated_time":{"oneOf":[{"type":"string","description":"Human-readable estimate of how long a run takes.","example":"10-20 min","uniqueKey":"estimated_time.oneOf.0","typeLabel":"string"},{"type":"null","description":"Human-readable estimate of how long a run takes.","example":"10-20 min","uniqueKey":"estimated_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"estimated_time","typeLabel":"string | null"},"is_valyu":{"type":"boolean","description":"Whether this is a Valyu-curated workflow (read-only to users).","example":true,"uniqueKey":"is_valyu","typeLabel":"boolean"},"owner_org_id":{"oneOf":[{"type":"string","description":"Organization that owns the workflow. `null` for Valyu-curated workflows.","example":null,"uniqueKey":"owner_org_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Organization that owns the workflow. `null` for Valyu-curated workflows.","example":null,"uniqueKey":"owner_org_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_org_id","typeLabel":"string | null"},"variables":{"type":"array","description":"Typed variables referenced by the prompt template. Up to 50.","items":{"type":"object","description":"A typed variable referenced by `{key}` placeholders in the workflow prompt template.","required":["key","label"],"properties":{"key":{"type":"string","description":"Unique key for the variable. Used as the `{key}` placeholder in the template and as the field name in `workflow_params`.","example":"company","isRequired":true,"uniqueKey":"variables.items.[INDEX].key","typeLabel":"string"},"label":{"type":"string","description":"Human-readable label for the variable.","example":"Company name","isRequired":true,"uniqueKey":"variables.items.[INDEX].label","typeLabel":"string"},"type":{"type":"string","description":"Input type for a workflow template variable. Controls how the variable is rendered and validated.","enum":["text","textarea","number","date","enum"],"example":"text","uniqueKey":"variables.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"required":{"type":"boolean","description":"Whether a value must be supplied for this variable.","default":false,"uniqueKey":"variables.items.[INDEX].required","typeLabel":"boolean"},"placeholder":{"type":"string","description":"Placeholder text shown in the input field.","example":"NVIDIA (NVDA)","uniqueKey":"variables.items.[INDEX].placeholder","typeLabel":"string"},"help":{"type":"string","description":"Help text explaining what to enter.","example":"The company you want to profile.","uniqueKey":"variables.items.[INDEX].help","typeLabel":"string"},"examples":{"type":"array","description":"Example values for the variable.","items":{"type":"string","uniqueKey":"variables.items.[INDEX].examples.items.[INDEX]","typeLabel":"string"},"example":["NVIDIA (NVDA)","Microsoft (MSFT)"],"uniqueKey":"variables.items.[INDEX].examples","typeLabel":"string[]"},"validation":{"type":"object","description":"Validation rules applied to the variable's value.","properties":{"min_length":{"type":"integer","description":"Minimum string length.","minimum":0,"uniqueKey":"variables.items.[INDEX].validation.min_length","typeLabel":"integer"},"max_length":{"type":"integer","description":"Maximum string length.","minimum":1,"uniqueKey":"variables.items.[INDEX].validation.max_length","typeLabel":"integer"},"pattern":{"type":"string","description":"Regular expression the value must match.","uniqueKey":"variables.items.[INDEX].validation.pattern","typeLabel":"string"},"enum":{"type":"array","description":"Allowed values when `type` is `enum`.","items":{"type":"string","uniqueKey":"variables.items.[INDEX].validation.enum.items.[INDEX]","typeLabel":"string"},"uniqueKey":"variables.items.[INDEX].validation.enum","typeLabel":"string[]"}},"uniqueKey":"variables.items.[INDEX].validation","typeLabel":"object"}},"uniqueKey":"variables.items.[INDEX]","typeLabel":"object"},"maxItems":50,"uniqueKey":"variables","typeLabel":"object[]"},"deliverables":{"type":"array","description":"Deliverables the workflow produces. Up to 20.","items":{"type":"object","description":"A deliverable file the workflow produces.","required":["type","description"],"properties":{"type":{"type":"string","description":"File format for the deliverable.","enum":["csv","xlsx","pptx","docx","pdf"],"example":"xlsx","isRequired":true,"uniqueKey":"deliverables.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"description":{"type":"string","description":"What the deliverable should contain.","example":"A model summary tab with revenue, margins, and key ratios.","isRequired":true,"uniqueKey":"deliverables.items.[INDEX].description","typeLabel":"string"}},"uniqueKey":"deliverables.items.[INDEX]","typeLabel":"object"},"maxItems":20,"uniqueKey":"deliverables","typeLabel":"object[]"},"created_at":{"type":"string","format":"date-time","description":"When the workflow was created.","example":"2026-01-10T12:00:00Z","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"When the workflow's current version was last published.","example":"2026-01-15T09:30:00Z","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"prompt":{"type":"string","description":"Prompt template with `{key}` placeholders. Included on detail (get/create/update) and on list with `?expand=true`.","example":"Build a company profile for {company} covering its business, financials, and recent developments.","uniqueKey":"prompt","typeLabel":"string"},"strategy":{"oneOf":[{"type":"string","description":"Research strategy. Maps to DeepResearch `research_strategy`. Included on detail and on list with `?expand=true`.","uniqueKey":"strategy.oneOf.0","typeLabel":"string"},{"type":"null","description":"Research strategy. Maps to DeepResearch `research_strategy`. Included on detail and on list with `?expand=true`.","uniqueKey":"strategy.oneOf.1","typeLabel":"null"}],"uniqueKey":"strategy","typeLabel":"string | null"},"report_format":{"oneOf":[{"type":"string","description":"Report format instructions. Maps to DeepResearch `report_format`. Included on detail and on list with `?expand=true`.","uniqueKey":"report_format.oneOf.0","typeLabel":"string"},{"type":"null","description":"Report format instructions. Maps to DeepResearch `report_format`. Included on detail and on list with `?expand=true`.","uniqueKey":"report_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"report_format","typeLabel":"string | null"},"tools":{"type":"object","description":"Optional tools the workflow's research agent may use.","properties":{"code_execution":{"type":"boolean","description":"Enable code execution in a sandboxed environment.","uniqueKey":"tools.code_execution","typeLabel":"boolean"},"screenshots":{"type":"boolean","description":"Enable visual screenshot capture of web pages.","uniqueKey":"tools.screenshots","typeLabel":"boolean"},"browser_use":{"type":"boolean","description":"Enable autonomous browser sessions.","uniqueKey":"tools.browser_use","typeLabel":"boolean"},"charts":{"type":"boolean","description":"Enable chart and graph generation in the report.","uniqueKey":"tools.charts","typeLabel":"boolean"}},"uniqueKey":"tools","typeLabel":"object"},"changelog":{"oneOf":[{"type":"string","description":"Changelog for the current version. Included on detail and on list with `?expand=true`.","uniqueKey":"changelog.oneOf.0","typeLabel":"string"},{"type":"null","description":"Changelog for the current version. Included on detail and on list with `?expand=true`.","uniqueKey":"changelog.oneOf.1","typeLabel":"null"}],"uniqueKey":"changelog","typeLabel":"string | null"},"output_formats":{"type":"array","description":"Output formats the workflow produces. Items are the strings `\"markdown\"`, `\"pdf\"`, or `\"toon\"`, and/or a single JSON Schema object for structured output. Rules: at most one JSON Schema object; a JSON Schema object cannot be combined with `\"markdown\"` or `\"pdf\"`; `\"toon\"` requires a JSON Schema object. An invalid combination returns `400 invalid_output_formats`.\n\nAt run time, a task created with `workflow_id` inherits the workflow's `output_formats` when the request does not pass its own; a request-level `output_formats` always wins.","items":{"oneOf":[{"type":"string","enum":["markdown","pdf","toon"],"uniqueKey":"output_formats.items.[INDEX].oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"object","description":"JSON Schema for structured output.","uniqueKey":"output_formats.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"output_formats.items.[INDEX]","typeLabel":"enum\u003cstring> | object"},"example":[{"type":"object","properties":{"base_case":{"type":"string"},"bull_case":{"type":"string"},"bear_case":{"type":"string"},"confidence":{"type":"number"}}},"toon"],"uniqueKey":"output_formats","typeLabel":"(enum\u003cstring> | object)[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"slug":"ib-company-profile","version":1,"title":"Company Profile","vertical":"investment-banking","tags":["company-profile","equities"],"subtitle":"One-page profile of a public company.","description":"Builds a company profile covering business, financials, and recent developments.","popular":true,"recommended_mode":"heavy","estimated_time":"10-20 min","is_valyu":true,"owner_org_id":null,"variables":[{"key":"company","label":"Company name","type":"text","required":false,"placeholder":"NVIDIA (NVDA)","help":"The company you want to profile.","examples":["NVIDIA (NVDA)","Microsoft (MSFT)"],"validation":{"min_length":1,"max_length":2,"pattern":"\u003cstring>","enum":["\u003cstring>"]}}],"deliverables":[{"type":"xlsx","description":"A model summary tab with revenue, margins, and key ratios."}],"created_at":"2026-01-10T12:00:00Z","updated_at":"2026-01-15T09:30:00Z","prompt":"Build a company profile for {company} covering its business, financials, and recent developments.","strategy":"\u003cstring>","report_format":"\u003cstring>","tools":{"code_execution":true,"screenshots":true,"browser_use":true,"charts":true},"changelog":"\u003cstring>","output_formats":[{"type":"object","properties":{"base_case":{"type":"string"},"bull_case":{"type":"string"},"bear_case":{"type":"string"},"confidence":{"type":"number"}}},"toon"]}}},"exampleType":"generated"}},"exampleType":"generated"},"18476da6-1d03-4e80-986b-ec390476a431":{"description":"The workflow request was invalid. The `error` field carries a machine-readable code and `message` a human-readable explanation.\n\nCommon codes:\n- `changelog_required` - a changelog is required when publishing a new version\n- `unreferenced_template_vars` - a declared variable is not used in the prompt template, or the template references an unknown variable\n- `invalid_output_formats` - `output_formats` contained more than one JSON schema, mixed a schema with `markdown`/`pdf`, or used `toon` without a schema\n- `field_too_long` - a text field exceeds its limit (64 KB)\n- `too_many_variables` - more than 50 variables\n- `too_many_deliverables` - more than 20 deliverables\n- `workflow_and_freeform_mutually_exclusive` - workflow and freeform fields were both supplied (on the DeepResearch create endpoint)","content":{"application/json":{"schema":{"type":"object","description":"Workflow error response. `error` is a machine-readable code; `message` is human-readable text.","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code.","example":"invalid_output_formats","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","example":"output_formats may contain at most one JSON schema, which cannot be combined with markdown or pdf.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"changelog_required":{"title":"changelog_required","value":{"error":"changelog_required","message":"A changelog is required when publishing a new version."}},"unreferenced_template_vars":{"title":"unreferenced_template_vars","value":{"error":"unreferenced_template_vars","message":"A declared variable is not used in the prompt template, or the template references an unknown variable."}},"invalid_output_formats":{"title":"invalid_output_formats","value":{"error":"invalid_output_formats","message":"output_formats may contain at most one JSON schema, which cannot be combined with markdown or pdf; toon requires a schema."}}},"exampleType":"examples"}},"exampleType":"examples"},"4f0e84ef-822f-4b44-8cc9-551f5205923d":{"description":"Missing or invalid API key. Send your key in the `X-API-Key` header.","content":{"application/json":{"schema":{"type":"object","description":"Error response. Every error body has `error`. Search, Contents, Answer and Datasources errors usually also carry `success: false`. Errors returned before a request reaches the endpoint (missing, invalid or disabled keys, rate limits) and DeepResearch errors have no `success` field. Some errors add a machine-readable `code` and a `recovery` object.","required":["error"],"properties":{"error":{"type":"string","description":"Error message, or a machine-readable code for some validation errors (for example `invalid_scope_policy`).","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"success":{"type":"boolean","description":"`false` when present.","example":false,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Human-readable detail. Present on errors returned before the request reaches the endpoint.","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when available. Branch on this rather than on the message text.","example":"insufficient_credits","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"object","description":"Links or details that help resolve the error, when available.","additionalProperties":true,"uniqueKey":"recovery","typeLabel":"object"},"transaction_id":{"type":"string","description":"Transaction ID for support, when available.","uniqueKey":"transaction_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"missing_or_invalid":{"title":"missing_or_invalid","value":{"error":"Unauthorized","message":"API key is missing or invalid"}},"invalid_key":{"title":"invalid_key","value":{"success":false,"error":"Invalid API key"}}},"exampleType":"examples"}},"exampleType":"examples"},"116aaba5-0e03-46d5-84c2-1abdb98088cd":{"description":"The operation is not permitted on this workflow.\n\nCommon codes:\n- `cannot_edit_valyu_workflow` - curated Valyu workflows are read-only\n- `cannot_delete_valyu_workflow` - curated Valyu workflows cannot be deleted","content":{"application/json":{"schema":{"type":"object","description":"Workflow error response. `error` is a machine-readable code; `message` is human-readable text.","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code.","example":"invalid_output_formats","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","example":"output_formats may contain at most one JSON schema, which cannot be combined with markdown or pdf.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"cannot_edit_valyu_workflow":{"title":"cannot_edit_valyu_workflow","value":{"error":"cannot_edit_valyu_workflow","message":"Valyu-curated workflows are read-only."}}},"exampleType":"examples"}},"exampleType":"examples"},"cc03cb5d-23b7-42da-a274-bb6da3503abe":{"description":"The workflow or version was not found.","content":{"application/json":{"schema":{"type":"object","description":"Workflow error response. `error` is a machine-readable code; `message` is human-readable text.","required":["error"],"properties":{"error":{"type":"string","description":"Machine-readable error code.","example":"invalid_output_formats","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"Human-readable explanation.","example":"output_formats may contain at most one JSON schema, which cannot be combined with markdown or pdf.","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"workflow_not_found":{"title":"workflow_not_found","value":{"error":"workflow_not_found","message":"No workflow matches that slug."}}},"exampleType":"examples"}},"exampleType":"examples"},"5ff220ec-ee4d-4655-b3ee-d9010fd601bf":{"description":"An unexpected error occurred on the server.","content":{"application/json":{"schema":{"type":"object","description":"Error response. Every error body has `error`. Search, Contents, Answer and Datasources errors usually also carry `success: false`. Errors returned before a request reaches the endpoint (missing, invalid or disabled keys, rate limits) and DeepResearch errors have no `success` field. Some errors add a machine-readable `code` and a `recovery` object.","required":["error"],"properties":{"error":{"type":"string","description":"Error message, or a machine-readable code for some validation errors (for example `invalid_scope_policy`).","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"success":{"type":"boolean","description":"`false` when present.","example":false,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","description":"Human-readable detail. Present on errors returned before the request reaches the endpoint.","uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"Stable machine-readable error code, when available. Branch on this rather than on the message text.","example":"insufficient_credits","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"object","description":"Links or details that help resolve the error, when available.","additionalProperties":true,"uniqueKey":"recovery","typeLabel":"object"},"transaction_id":{"type":"string","description":"Transaction ID for support, when available.","uniqueKey":"transaction_id","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"example":{"title":"example","value":{"success":false,"error":"Internal server error. Please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"94d79a2e-4187-471a-9be9-391d4fe3e7f6":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Get yours at [platform.valyu.ai](https://platform.valyu.ai).","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"4ec95c84-073b-4972-924a-67bee24f05ec":{"url":"https://api.valyu.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication. Get yours at [platform.valyu.ai](https://platform.valyu.ai).","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication. Get yours at [platform.valyu.ai](https://platform.valyu.ai).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"valyu","siteName":"Valyu","title":"Workflows - Update | Valyu","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T12:28:29.741Z","originalFileLocation":"api-reference/endpoint/workflows-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=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Edit a custom org Workflow, creating a new version with a changelog.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Valyu\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_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/valyu/CrEJpfpruXuhNB-H/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Workflows - Update | Valyu\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Valyu\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.valyu.ai/api-reference/endpoint/workflows-update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://valyu.mintlify.app/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Update+Workflow\u0026amp;description=Edit+a+custom+org+Workflow%2C+creating+a+new+version+with+a+changelog.\u0026amp;theme=5c49058aa7e20d25b5fd776c\u0026amp;signature=0142136ddf070358291d34163faecc6b68e8d44682d5c9e14b385b4134a36e20\">\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=\"Workflows - Update | Valyu\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reference for updating a custom org Workflow via PATCH /v1/workflows/{slug}.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://valyu.mintlify.app/_mintlify/api/og/v2?division=Workflows\u0026amp;title=Update+Workflow\u0026amp;description=Edit+a+custom+org+Workflow%2C+creating+a+new+version+with+a+changelog.\u0026amp;theme=5c49058aa7e20d25b5fd776c\u0026amp;signature=0142136ddf070358291d34163faecc6b68e8d44682d5c9e14b385b4134a36e20\">\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/valyu/CrEJpfpruXuhNB-H/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Valyu\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5E3454\">\u003cmeta data-mint-head name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\u003cmeta data-mint-head name=\"twitter:creator\" content=\"@ValyuOfficial\">\u003cmeta data-mint-head name=\"googlebot\" content=\"index, follow\">\u003cmeta data-mint-head name=\"author\" content=\"Valyu\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.valyu.ai/api-reference/endpoint/workflows-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/endpoint/workflows-update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.valyu.ai/#organization\",\"name\":\"Valyu\",\"url\":\"https://www.valyu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/valyu/XSNGAn-w-x47KJwH/logo/valyu-wordmark-light.svg?fit=max\u0026auto=format\u0026n=XSNGAn-w-x47KJwH\u0026q=85\u0026s=334dd47b5c8dd1f11877b78e19848e24\"},\"sameAs\":[\"https://x.com/ValyuOfficial\",\"https://linkedin.com/company/valyu-ai\",\"https://github.com/valyuAI\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.valyu.ai#website\",\"name\":\"Valyu\",\"url\":\"https://docs.valyu.ai\",\"publisher\":{\"@id\":\"https://www.valyu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update#webpage\",\"url\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update\",\"name\":\"Update Workflow\",\"description\":\"Edit a custom org Workflow, creating a new version with a changelog.\",\"dateModified\":\"2026-10-20T12:28:29.741Z\",\"isPartOf\":{\"@id\":\"https://docs.valyu.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Workflows\",\"item\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Update Workflow\",\"item\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update#apireference\",\"headline\":\"Update Workflow\",\"name\":\"Update Workflow\",\"description\":\"Edit a custom org Workflow, creating a new version with a changelog.\",\"url\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.valyu.ai/api-reference/endpoint/workflows-update#webpage\"},\"dateModified\":\"2026-10-20T12:28:29.741Z\",\"publisher\":{\"@id\":\"https://www.valyu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.valyu.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Valyu\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Valyu","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/home"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"API essentials","pages":[{"title":"API reference","sidebarTitle":"Overview","href":"/api-reference/overview"}]},{"group":"Search","icon":"magnifying-glass","pages":[{"title":"Search","openapi":"POST /v1/search","href":"/api-reference/endpoint/search"}]},{"group":"Contents","icon":"file-lines","pages":[{"title":"Contents","openapi":"POST /v1/contents","href":"/api-reference/endpoint/contents"},{"title":"Contents Job Status","openapi":"GET /v1/contents/jobs/{job_id}","href":"/api-reference/endpoint/contents-job"}]},{"group":"Answer","icon":"message","pages":[{"title":"Answer","openapi":"POST /v1/answer","href":"/api-reference/endpoint/answer"}]},{"group":"DeepResearch","icon":"flask","pages":[{"title":"Create Task","openapi":"POST /v1/deepresearch/tasks","href":"/api-reference/endpoint/deepresearch-create"},{"title":"Get Status","openapi":"GET /v1/deepresearch/tasks/{id}/status","href":"/api-reference/endpoint/deepresearch-status"},{"title":"List Tasks","openapi":"GET /v1/deepresearch/list","href":"/api-reference/endpoint/deepresearch-list"},{"title":"Update Task","openapi":"POST /v1/deepresearch/tasks/{id}/update","href":"/api-reference/endpoint/deepresearch-update"},{"title":"Toggle Public Access","openapi":"POST /v1/deepresearch/tasks/{id}/public","href":"/api-reference/endpoint/deepresearch-public"},{"title":"Respond to HITL Checkpoint","openapi":"POST /v1/deepresearch/tasks/{id}/respond","href":"/api-reference/endpoint/deepresearch-respond"},{"title":"Cancel Task","openapi":"POST /v1/deepresearch/tasks/{id}/cancel","href":"/api-reference/endpoint/deepresearch-cancel"},{"title":"Delete Task","openapi":"DELETE /v1/deepresearch/tasks/{id}/delete","href":"/api-reference/endpoint/deepresearch-delete"}]},{"group":"DeepResearch (Batch)","icon":"layer-group","pages":[{"title":"Create Batch","openapi":"POST /v1/deepresearch/batches","href":"/api-reference/endpoint/deepresearch-batch-create"},{"title":"List Batches","openapi":"GET /v1/deepresearch/batches","href":"/api-reference/endpoint/deepresearch-batch-list"},{"title":"Get Batch Status","openapi":"GET /v1/deepresearch/batches/{id}","href":"/api-reference/endpoint/deepresearch-batch-status"},{"title":"Add Tasks to Batch","openapi":"POST /v1/deepresearch/batches/{id}/tasks","href":"/api-reference/endpoint/deepresearch-batch-add-tasks"},{"title":"List Batch Tasks","openapi":"GET /v1/deepresearch/batches/{id}/tasks","href":"/api-reference/endpoint/deepresearch-batch-list-tasks"},{"title":"Cancel Batch","openapi":"POST /v1/deepresearch/batches/{id}/cancel","href":"/api-reference/endpoint/deepresearch-batch-cancel"}]},{"group":"Workflows","icon":"diagram-project","tag":"Beta","pages":[{"title":"List Workflows","openapi":"GET /v1/workflows","href":"/api-reference/endpoint/workflows-list"},{"title":"Get Workflow","openapi":"GET /v1/workflows/{slug}","href":"/api-reference/endpoint/workflows-get"},{"title":"Create Workflow","description":"Reference for creating a custom org Workflow template via POST /v1/workflows.","openapi":"POST /v1/workflows","href":"/api-reference/endpoint/workflows-create"},{"title":"Update Workflow","openapi":"PATCH /v1/workflows/{slug}","href":"/api-reference/endpoint/workflows-update"},{"title":"Delete Workflow","description":"Reference for soft-deleting a custom org Workflow via DELETE /v1/workflows/{slug}.","openapi":"DELETE /v1/workflows/{slug}","href":"/api-reference/endpoint/workflows-delete"},{"title":"List Workflow Versions","openapi":"GET /v1/workflows/{slug}/versions","href":"/api-reference/endpoint/workflows-versions"},{"title":"Preview Workflow","openapi":"POST /v1/workflows/{slug}/preview","href":"/api-reference/endpoint/workflows-preview"}]},{"group":"Datasources","icon":"database","pages":[{"title":"List Datasources","openapi":"GET /v1/datasources","href":"/api-reference/endpoint/datasources-list"},{"title":"List Categories","openapi":"GET /v1/datasources/categories","href":"/api-reference/endpoint/datasources-categories"},{"title":"Search Datasources","openapi":"GET /v1/datasources/search","href":"/api-reference/endpoint/datasources-search"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/platform"}]}]},"title":"Workflows - Update | Valyu","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}