Replace a cross-service edge with an edited declaration.Edges cannot change in place: this declares the edge in —from-file, then
removes EDGE_ID, so the edge gets a new ID. Not atomic: if the removal
fails, both edges exist and the command says how to remove the old one.Use edge generate —from-edge to export an edge for editing first.
Usage
gable lineage edge update EDGE_ID [OPTIONS]
Options
Option
Type
Required
Default
Description
--endpoint
text
Customer API endpoint for Gable, in the format https://api.company.gable.ai/. Can also be set with the GABLE_API_ENDPOINT environment variable.
--api-key
text
API Key for Gable. Can also be set with the GABLE_API_KEY environment variable.
--from-file
text
Path to JSON file containing edge definition, or pipe JSON to stdin.
--dry-run
boolean
false
Preview changes without applying.
Arguments
EDGE_ID — Required
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Gable Docs","colors":{"primary":"#916bff","light":"#916bff","dark":"#916bff"},"logo":{"light":"https://mintlify.s3.us-west-1.amazonaws.com/gable/static/img/Inline-logo-light.svg","dark":"https://mintlify.s3.us-west-1.amazonaws.com/gable/static/img/Inline-logo-dark.svg","href":"https://www.gable.ai/"},"favicon":"https://mintcdn.com/gable/yTF_sjajzmUvUtbD/static/img/favicon.ico?fit=max\u0026auto=format\u0026n=yTF_sjajzmUvUtbD\u0026q=85\u0026s=1a5d8a00a289e04ece674494b03443f3","navbar":{"links":[{"href":"https://www.gable.ai/","label":"Gable.ai Home"}]},"icons":{"library":"lucide"},"integrations":{"ga4":{"measurementId":"G-XXXXXXXXXX"}},"contextual":{"options":["chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gable","hasAudioNarration":false,"actualSubdomain":"gable","customDomains":["docs.gable.ai"],"gitSource":{"type":"github","owner":"gabledata","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afb671878d6ad4071fed2b7","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Specifications","count":97},{"language":"default","tag":"Gable","count":96},{"language":"default","tag":"lineage","count":62},{"language":"default","tag":"CLI Reference","count":37},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"component","count":21},{"language":"default","tag":"settings","count":9},{"language":"default","tag":"auth","count":7},{"language":"default","tag":"edge","count":7},{"language":"default","tag":"datastore","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"docs/cli/lineage/edge/update","slug":"/docs/cli/lineage/edge/update","pageMetadata":{"title":"gable lineage edge update","description":null,"href":"/docs/cli/lineage/edge/update"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Replace a cross-service edge with an edited declaration.`}),`\n`,_jsx(_components.p,{children:`Edges cannot change in place: this declares the edge in —from-file, then\nremoves EDGE_ID, so the edge gets a new ID. Not atomic: if the removal\nfails, both edges exist and the command says how to remove the old one.`}),`\n`,_jsx(_components.p,{children:`Use edge generate —from-edge to export an edge for editing first.`}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gable`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` lineage`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` edge`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` EDGE_ID`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [OPTIONS]`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`options`,children:`Options`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Option`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--endpoint`})}),_jsx(_components.td,{children:`text`}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`Customer API endpoint for Gable, in the format `,_jsx(_components.a,{href:`https://api.company.gable.ai/`,children:`https://api.company.gable.ai/`}),`. Can also be set with the GABLE_API_ENDPOINT environment variable.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--api-key`})}),_jsx(_components.td,{children:`text`}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{children:`API Key for Gable. Can also be set with the GABLE_API_KEY environment variable.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--from-file`})}),_jsx(_components.td,{children:`text`}),_jsx(_components.td,{}),_jsx(_components.td,{}),_jsx(_components.td,{children:`Path to JSON file containing edge definition, or pipe JSON to stdin.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--dry-run`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{}),_jsx(_components.td,{children:`false`}),_jsx(_components.td,{children:`Preview changes without applying.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`arguments`,children:`Arguments`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`EDGE_ID`})}),` — Required`]})]})}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":"gable lineage edge update","description":null,"href":"/docs/cli/lineage/edge/update"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Usage","slug":"usage","depth":2,"children":[]},{"title":"Options","slug":"options","depth":2,"children":[]},{"title":"Arguments","slug":"arguments","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/gable/eede5d4d78ad5f90/scripts/redocly-docs-plugin.js"],"subdomain":"gable","siteName":"Gable Docs","title":"gable lineage edge update - Gable Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T17:55:22.403Z","originalFileLocation":"docs/cli/lineage/edge/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=\"application-name\" content=\"Gable 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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_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/gable/IgDUKT8dRM-BqXKX/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"gable lineage edge update - Gable Docs\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gable Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gable.ai/docs/cli/lineage/edge/update\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gable.mintlify.site/_mintlify/api/og/v2?division=edge\u0026amp;title=gable+lineage+edge+update\u0026amp;theme=2196b5e3c29e5e44c0add548\u0026amp;signature=714c0d7ab24ec9241383c4d7357b0e317eb1c14f3329addfb0cd6664d5502a2d\">\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=\"gable lineage edge update - Gable Docs\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gable.mintlify.site/_mintlify/api/og/v2?division=edge\u0026amp;title=gable+lineage+edge+update\u0026amp;theme=2196b5e3c29e5e44c0add548\u0026amp;signature=714c0d7ab24ec9241383c4d7357b0e317eb1c14f3329addfb0cd6664d5502a2d\">\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/gable/IgDUKT8dRM-BqXKX/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gable Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#916bff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gable.ai/docs/cli/lineage/edge/update\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/cli/lineage/edge/update.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gable.ai/#organization\",\"name\":\"Gable Docs\",\"url\":\"https://docs.gable.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintlify.s3.us-west-1.amazonaws.com/gable/static/img/Inline-logo-light.svg\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gable.ai#website\",\"name\":\"Gable Docs\",\"url\":\"https://docs.gable.ai\",\"publisher\":{\"@id\":\"https://docs.gable.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gable.ai/docs/cli/lineage/edge/update#webpage\",\"url\":\"https://docs.gable.ai/docs/cli/lineage/edge/update\",\"name\":\"gable lineage edge update\",\"dateModified\":\"2026-11-04T17:55:22.403Z\",\"isPartOf\":{\"@id\":\"https://docs.gable.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gable.ai/docs/cli/lineage/edge/update#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gable.ai/docs/cli/lineage/edge/update#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"lineage\",\"item\":\"https://docs.gable.ai/docs/cli/lineage\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"edge\",\"item\":\"https://docs.gable.ai/docs/cli/lineage/edge\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"gable lineage edge update\",\"item\":\"https://docs.gable.ai/docs/cli/lineage/edge/update\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gable.ai/docs/cli/lineage/edge/update#article\",\"headline\":\"gable lineage edge update\",\"name\":\"gable lineage edge update\",\"url\":\"https://docs.gable.ai/docs/cli/lineage/edge/update\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gable.ai/docs/cli/lineage/edge/update#webpage\"},\"dateModified\":\"2026-11-04T17:55:22.403Z\",\"publisher\":{\"@id\":\"https://docs.gable.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gable.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gable Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gable Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/cli/lineage/edge/update.md","siteName":"Gable Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/intro"}]},{"tab":"API Specifications","icon":"book","pages":[{"title":"API Specifications","href":"/api-reference/introduction"}]},{"tab":"CLI Reference","icon":"terminal","groups":[{"group":"Getting Started","pages":[{"title":"CLI Reference","href":"/docs/cli/introduction"}]},{"group":"auth","pages":[{"title":"gable auth","href":"/docs/cli/auth"},{"title":"gable auth key","href":"/docs/cli/auth/key"},{"title":"gable auth npm","href":"/docs/cli/auth/npm"},{"title":"gable auth pip","href":"/docs/cli/auth/pip"}]},{"group":"lineage","pages":[{"title":"gable lineage","href":"/docs/cli/lineage"},{"title":"gable lineage compare","href":"/docs/cli/lineage/compare"},{"group":"component","pages":[{"title":"gable lineage component","href":"/docs/cli/lineage/component"},{"title":"gable lineage component export","href":"/docs/cli/lineage/component/export"},{"title":"gable lineage component get","href":"/docs/cli/lineage/component/get"},{"title":"gable lineage component list","href":"/docs/cli/lineage/component/list"},{"group":"path","pages":[{"title":"gable lineage component path","href":"/docs/cli/lineage/component/path"},{"title":"gable lineage component path get","href":"/docs/cli/lineage/component/path/get"},{"title":"gable lineage component path list","href":"/docs/cli/lineage/component/path/list"}]},{"group":"tags","pages":[{"title":"gable lineage component tags","href":"/docs/cli/lineage/component/tags"},{"title":"gable lineage component tags add","href":"/docs/cli/lineage/component/tags/add"},{"title":"gable lineage component tags list","href":"/docs/cli/lineage/component/tags/list"},{"title":"gable lineage component tags remove","href":"/docs/cli/lineage/component/tags/remove"}]},{"title":"gable lineage component versions","href":"/docs/cli/lineage/component/versions"}]},{"group":"datastore","pages":[{"title":"gable lineage datastore","href":"/docs/cli/lineage/datastore"},{"title":"gable lineage datastore add","href":"/docs/cli/lineage/datastore/add"},{"title":"gable lineage datastore generate","href":"/docs/cli/lineage/datastore/generate"},{"title":"gable lineage datastore get","href":"/docs/cli/lineage/datastore/get"},{"title":"gable lineage datastore list","href":"/docs/cli/lineage/datastore/list"},{"title":"gable lineage datastore update","href":"/docs/cli/lineage/datastore/update"}]},{"group":"edge","pages":[{"title":"gable lineage edge","href":"/docs/cli/lineage/edge"},{"title":"gable lineage edge add","href":"/docs/cli/lineage/edge/add"},{"title":"gable lineage edge generate","href":"/docs/cli/lineage/edge/generate"},{"title":"gable lineage edge get","href":"/docs/cli/lineage/edge/get"},{"title":"gable lineage edge list","href":"/docs/cli/lineage/edge/list"},{"title":"gable lineage edge remove","description":null,"href":"/docs/cli/lineage/edge/remove"},{"title":"gable lineage edge update","href":"/docs/cli/lineage/edge/update"}]},{"title":"gable lineage export","description":null,"href":"/docs/cli/lineage/export"},{"title":"gable lineage scan","href":"/docs/cli/lineage/scan"},{"title":"gable lineage upload","href":"/docs/cli/lineage/upload"}]},{"group":"Other","pages":[{"title":"gable ping","href":"/docs/cli/ping"},{"title":"gable ui","href":"/docs/cli/ui"}]}]}]},"basePath":"","title":"gable lineage edge update - Gable Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}