Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.
Your own name for the device, to help you find it later. Omit the key to keep the current label, send null or a blank string to clear it, send text to set it. Maximum 256 characters.
One device in Leap's catalog. Send its id as the device_id on a lookup. Specification fields such as capacity_kw or seer2_rating are populated where Leap holds data for that device type, and are null otherwise.
Your own name for the device, when you set one. Null otherwise.
Was this page helpful?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Leap Incentives Gateway","colors":{"primary":"#7C3AED","light":"#A855F7","dark":"#6D28D9"},"logo":{"light":"https://mintcdn.com/leap-fa97d36a/o6t9FZsEU8eaeSsd/logo/leap_black.svg?fit=max\u0026auto=format\u0026n=o6t9FZsEU8eaeSsd\u0026q=85\u0026s=5fdf37df236af7ead485adb763fbd593","dark":"https://mintcdn.com/leap-fa97d36a/o6t9FZsEU8eaeSsd/logo/leap_white.svg?fit=max\u0026auto=format\u0026n=o6t9FZsEU8eaeSsd\u0026q=85\u0026s=016beb1613f37561ca3a57d60bd2025e"},"favicon":"https://mintcdn.com/leap-fa97d36a/OykPB5F7m0AyNOAT/favicon.svg?fit=max\u0026auto=format\u0026n=OykPB5F7m0AyNOAT\u0026q=85\u0026s=f1054b2c60ae565e37733bcf99008f4b","appearance":{"default":"dark","strict":false},"background":{"decoration":"grid","color":{"light":"#FFFFFF","dark":"#0A0A0B"}},"navbar":{"links":[{"href":"https://partner.incentives.leap.energy/sign-in","label":"Log in"}],"primary":{"type":"button","label":"Get Started","href":"https://partner.incentives.leap.energy/sign-up"}},"footer":{"socials":{"x":"https://x.com/leapdex","linkedin":"https://www.linkedin.com/company/leap-dex"}},"fonts":{"family":"Geist"},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":false},"integrations":{"ga4":{"measurementId":"G-PF7MQ92GG6"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"leap-fa97d36a","hasAudioNarration":false,"actualSubdomain":"leap-fa97d36a","customDomains":["docs.incentives.leap.energy"],"gitSource":{"type":"github","owner":"leapac","repo":"rebates-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad96798bba12945c1ccfee1","collectionId":"2e9a5ac8-bcea-4860-a233-b431ae6d2645","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad96798bba12945c1ccfee1"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ad96798bba12945c1ccfee1","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"Applications","count":9},{"language":"default","tag":"Incentives","count":5},{"language":"default","tag":"Attachments","count":5},{"language":"default","tag":"Devices","count":4},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Saved devices","count":3},{"language":"default","tag":"Programs","count":3},{"language":"default","tag":"VPP Offers","count":1}]},"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":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F63fjptAgt5VM-kVkqdyU8n1iIq129k.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F63fjptAgt5VM-kVkqdyU8n1isq129k.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F63fjptAgt5VM-kVkqdyU8n1iAq129k.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F63fjptAgt5VM-kVkqdyU8n1iEq129k.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F63fjptAgt5VM-kVkqdyU8n1i8q1w.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3twJwl1FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3twJwlRFgtIU.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3twJwl9FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3twJwl5FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3twJwlBFgg.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl1FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3vAOwlRFgtIU.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* vietnamese */\n@font-face {\n font-family: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl9FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3vAOwl5FgtIU.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: 'IBM Plex Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/ibmplexmono/v20/-F6qfjptAgt5VM-kVkqdyU8n3vAOwlBFgg.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:root{--leap-violet:#a855f7;--leap-violet-deep:#7c3aed;--leap-graphite:#0a0a0b}.code-block,[class*=code] code,code,kbd,pre{font-family:'IBM Plex Mono',ui-monospace,'SF Mono',Menlo,monospace!important;font-variant-numeric:tabular-nums;font-feature-settings:'zero' 1}.dark #background-color,.light #background-color{background-image:linear-gradient(to right,rgba(255,255,255,.028) 1px,transparent 1px),linear-gradient(to bottom,rgba(255,255,255,.028) 1px,transparent 1px);background-size:44px 44px}.light #background-color{background-image:linear-gradient(to right,rgba(10,10,11,.035) 1px,transparent 1px),linear-gradient(to bottom,rgba(10,10,11,.035) 1px,transparent 1px)}.tryit-button,[class*='bg-[#3064E3]']{background-color:var(--leap-violet-deep)!important;color:#fff!important}.tryit-button:hover{background-color:var(--leap-violet)!important;opacity:1}a{transition:color 150ms ease-out}a:hover{color:var(--leap-violet)}:focus-visible{outline:2px solid var(--leap-violet);outline-offset:2px;border-radius:2px}::selection{background:color-mix(in oklab,var(--leap-violet) 28%,transparent)}#footer,#navbar,#sidebar{border-color:rgba(255,255,255,.08)}@media (prefers-reduced-motion:reduce){*,::after,::before{transition-duration:.01ms!important;animation-duration:.01ms!important}}"}],"page":{"pagePath":"api-reference/devices/save-a-device","slug":"/api-reference/devices/save-a-device","pageMetadata":{"title":"Save a device","description":"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json put /beta/incentives/devices/saved/{device_id}","href":"/api-reference/devices/save-a-device","autogeneratedByOpenApi":true},"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: \"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Save a device","description":"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json put /beta/incentives/devices/saved/{device_id}","href":"/api-reference/devices/save-a-device","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["devices"],"summary":"Save a device","description":"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.","operationId":"upsertSavedDevice","parameters":["91b58a8b-6d0e-40f1-84ba-06e7baa2f94f"],"requestBody":"5d37b5ad-ccd8-4e3c-a633-924806426a25","responses":{"200":"f4c5c796-f7a8-453d-8e97-ed89ec007b3c","400":"68ac0738-bf5e-429f-97ca-ec9a29e96b4c","401":"03c9717a-315f-4680-aea1-690669b2e23d","403":"52c6393f-3cec-4041-a8e1-9892cb59431d","404":"7d93e46e-6d0a-4fb0-818b-403d82e7bec3","429":"01d2dafc-1049-421d-be06-846104bbe45f","500":"94eab856-2f29-413c-8004-ccf6278b435b"},"method":"put","type":"path","servers":["e8c073f3-c9db-46e8-bcc6-edf2f8f87742","b1d736c3-e164-46b3-8822-d75ddae4ffbb"],"security":["f346ac79-e6f3-4e3a-8ca7-9517baff62b2"],"path":"/beta/incentives/devices/saved/{device_id}","baseUrlOptions":["https://api.leap.energy","https://api.staging.leap.energy"],"title":"Save a device","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"91b58a8b-6d0e-40f1-84ba-06e7baa2f94f":{"name":"device_id","in":"path","required":true,"description":"Catalog device UUID (as returned by the device search).","schema":{"type":"string","format":"uuid","isRequired":true,"description":"Catalog device UUID (as returned by the device search).","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"label":{"oneOf":[{"type":"string","maxLength":256,"description":"Your own name for the device, to help you find it later. Omit the key to keep the current label, send null or a blank string to clear it, send text to set it. Maximum 256 characters.","uniqueKey":"label.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":256,"description":"Your own name for the device, to help you find it later. Omit the key to keep the current label, send null or a blank string to clear it, send text to set it. Maximum 256 characters.","uniqueKey":"label.oneOf.1","typeLabel":"null"}],"uniqueKey":"label","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"label":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f4c5c796-f7a8-453d-8e97-ed89ec007b3c":{"description":"The saved device after the upsert.","content":{"application/json":{"schema":{"type":"object","required":["device_id","created_at","device"],"properties":{"device_id":{"type":"string","format":"uuid","description":"Catalog device UUID. This is the `device_id` you send on a lookup.","isRequired":true,"uniqueKey":"device_id","typeLabel":"string\u003cuuid>"},"created_at":{"type":"string","format":"date-time","description":"When you first saved this device.","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"device":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"device.id","typeLabel":"string\u003cuuid>"},"device_category_id":{"type":"string","format":"uuid","description":"Leap's identifier for the device's category. It is specific to one Leap environment, so key on `device_category` instead when you store or compare categories.","uniqueKey":"device.device_category_id","typeLabel":"string\u003cuuid>"},"device_category":{"type":"string","description":"The device's category name, and the stable way to address a category: `hvac`, `ev_charger`, `solar_storage`, `water_heater`, `smart_thermostat`, `weatherization`, `vehicle`, `meter`, `panel_make_ready`, `solar_panel`. It is the same value the `category` query parameter takes, so you can bucket a page of results without a second call.","uniqueKey":"device.device_category","typeLabel":"string"},"manufacturer":{"type":"string","uniqueKey":"device.manufacturer","typeLabel":"string"},"model_number":{"type":"string","uniqueKey":"device.model_number","typeLabel":"string"},"model_name":{"type":"string","uniqueKey":"device.model_name","typeLabel":"string"},"description":{"type":"string","uniqueKey":"device.description","typeLabel":"string"},"subcategory":{"type":"string","uniqueKey":"device.subcategory","typeLabel":"string"},"is_active":{"type":"boolean","uniqueKey":"device.is_active","typeLabel":"boolean"},"date_available":{"type":"string","format":"date","uniqueKey":"device.date_available","typeLabel":"string\u003cdate>"},"date_discontinued":{"type":"string","format":"date","uniqueKey":"device.date_discontinued","typeLabel":"string\u003cdate>"},"manufacture_year":{"type":"integer","uniqueKey":"device.manufacture_year","typeLabel":"integer"},"charger_level":{"type":"string","uniqueKey":"device.charger_level","typeLabel":"string"},"charging_power_kw":{"type":"number","uniqueKey":"device.charging_power_kw","typeLabel":"number"},"connector_types":{"type":"array","items":{"type":"string","uniqueKey":"device.connector_types.items.[INDEX]","typeLabel":"string"},"uniqueKey":"device.connector_types","typeLabel":"string[]"},"seer2_rating":{"type":"number","uniqueKey":"device.seer2_rating","typeLabel":"number"},"eer2_rating":{"type":"number","uniqueKey":"device.eer2_rating","typeLabel":"number"},"hspf2_rating":{"type":"number","uniqueKey":"device.hspf2_rating","typeLabel":"number"},"ceer_rating":{"type":"number","uniqueKey":"device.ceer_rating","typeLabel":"number"},"capacity_tons":{"type":"number","uniqueKey":"device.capacity_tons","typeLabel":"number"},"capacity_btu":{"type":"integer","uniqueKey":"device.capacity_btu","typeLabel":"integer"},"capacity_kw":{"type":"number","uniqueKey":"device.capacity_kw","typeLabel":"number"},"msrp":{"type":"number","uniqueKey":"device.msrp","typeLabel":"number"},"is_energy_star_certified":{"type":"boolean","uniqueKey":"device.is_energy_star_certified","typeLabel":"boolean"},"is_ul_listed":{"type":"boolean","uniqueKey":"device.is_ul_listed","typeLabel":"boolean"},"is_networked":{"type":"boolean","uniqueKey":"device.is_networked","typeLabel":"boolean"},"is_ocpp_compliant":{"type":"boolean","uniqueKey":"device.is_ocpp_compliant","typeLabel":"boolean"},"battery_capacity_kwh":{"type":"number","uniqueKey":"device.battery_capacity_kwh","typeLabel":"number"},"battery_chemistry":{"type":"string","uniqueKey":"device.battery_chemistry","typeLabel":"string"},"is_mobile_plugin_charger":{"type":"boolean","uniqueKey":"device.is_mobile_plugin_charger","typeLabel":"boolean"}},"description":"One device in Leap's catalog. Send its `id` as the `device_id` on a lookup. Specification fields such as `capacity_kw` or `seer2_rating` are populated where Leap holds data for that device type, and are null otherwise.","isRequired":true,"uniqueKey":"device","typeLabel":"object"},"label":{"oneOf":[{"type":"string","description":"Your own name for the device, when you set one. Null otherwise.","uniqueKey":"label.oneOf.0","typeLabel":"string"},{"type":"null","description":"Your own name for the device, when you set one. Null otherwise.","uniqueKey":"label.oneOf.1","typeLabel":"null"}],"uniqueKey":"label","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"device_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","created_at":"2023-11-07T05:31:56Z","device":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","device_category_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","device_category":"\u003cstring>","manufacturer":"\u003cstring>","model_number":"\u003cstring>","model_name":"\u003cstring>","description":"\u003cstring>","subcategory":"\u003cstring>","is_active":true,"date_available":"2023-12-25","date_discontinued":"2023-12-25","manufacture_year":123,"charger_level":"\u003cstring>","charging_power_kw":123,"connector_types":["\u003cstring>"],"seer2_rating":123,"eer2_rating":123,"hspf2_rating":123,"ceer_rating":123,"capacity_tons":123,"capacity_btu":123,"capacity_kw":123,"msrp":123,"is_energy_star_certified":true,"is_ul_listed":true,"is_networked":true,"is_ocpp_compliant":true,"battery_capacity_kwh":123,"battery_chemistry":"\u003cstring>","is_mobile_plugin_charger":true},"label":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"68ac0738-bf5e-429f-97ca-ec9a29e96b4c":{"description":"Malformed or invalid request","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"03c9717a-315f-4680-aea1-690669b2e23d":{"description":"You are not authorized to perform this operation","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"52c6393f-3cec-4041-a8e1-9892cb59431d":{"description":"You do not have permission to perform this operation","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"7d93e46e-6d0a-4fb0-818b-403d82e7bec3":{"description":"The requested resource was not found","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"01d2dafc-1049-421d-be06-846104bbe45f":{"description":"The shared per-partner rate limit for /incentives endpoints was exceeded (`error_code: RATE_LIMIT_EXCEEDED`). Back off and retry after the number of seconds indicated by the `Retry-After` header.\n","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"94eab856-2f29-413c-8004-ccf6278b435b":{"description":"An internal server error occurred","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"error_code":{"type":"string","uniqueKey":"error.details.items.[INDEX].error_code","typeLabel":"string"},"reason":{"type":"string","uniqueKey":"error.details.items.[INDEX].reason","typeLabel":"string"}},"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"uniqueKey":"error.details","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"message":"\u003cstring>","details":[{"error_code":"\u003cstring>","reason":"\u003cstring>"}]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f346ac79-e6f3-4e3a-8ca7-9517baff62b2":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Your Leap API key as a Bearer token. Send it in the `Authorization` header: `Authorization: Bearer \u003capi-key>`.","scopes":[]}}},"servers":{"e8c073f3-c9db-46e8-bcc6-edf2f8f87742":{"url":"https://api.leap.energy","description":"Production"},"b1d736c3-e164-46b3-8822-d75ddae4ffbb":{"url":"https://api.staging.leap.energy","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Your Leap API key as a Bearer token. Send it in the `Authorization` header: `Authorization: Bearer \u003capi-key>`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Your Leap API key as a Bearer token. Send it in the `Authorization` header: `Authorization: Bearer \u003capi-key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"api-reference/specs/gcs-devices.json"},"subdomain":"leap-fa97d36a","siteName":"Leap Incentives Gateway","title":"Save a device - Leap Incentives Gateway","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-17T13:04:32.053Z","originalFileLocation":"api-reference/devices/save-a-device.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=\"dark\"}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=\"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Leap Incentives Gateway\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Save a device - Leap Incentives Gateway\">\u003cmeta data-mint-head property=\"og:description\" content=\"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Leap Incentives Gateway\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://leap-fa97d36a.mintlify.app/_mintlify/api/og/v2?division=Saved+devices\u0026amp;title=Save+a+device\u0026amp;description=Add+a+catalog+device+to+your+saved+list%2C+or+relabel+one+you+already+saved.+Repeating+the+call+updates+the+existing+entry+instead+of+adding+a+second+one.+A+catal\u0026amp;theme=a1c4742db67240f75c71063c\u0026amp;signature=89f34219a08c2220b94b67d5c50bca7ffcaf93da350063f6d6648ea65c2877f0\">\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=\"Save a device - Leap Incentives Gateway\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://leap-fa97d36a.mintlify.app/_mintlify/api/og/v2?division=Saved+devices\u0026amp;title=Save+a+device\u0026amp;description=Add+a+catalog+device+to+your+saved+list%2C+or+relabel+one+you+already+saved.+Repeating+the+call+updates+the+existing+entry+instead+of+adding+a+second+one.+A+catal\u0026amp;theme=a1c4742db67240f75c71063c\u0026amp;signature=89f34219a08c2220b94b67d5c50bca7ffcaf93da350063f6d6648ea65c2877f0\">\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/leap-fa97d36a/UjOw-lUYdKhaJrQR/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Leap Incentives Gateway\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/devices/save-a-device.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.incentives.leap.energy/#organization\",\"name\":\"Leap Incentives Gateway\",\"url\":\"https://docs.incentives.leap.energy\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/leap-fa97d36a/o6t9FZsEU8eaeSsd/logo/leap_black.svg?fit=max\u0026auto=format\u0026n=o6t9FZsEU8eaeSsd\u0026q=85\u0026s=5fdf37df236af7ead485adb763fbd593\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.incentives.leap.energy#website\",\"name\":\"Leap Incentives Gateway\",\"url\":\"https://docs.incentives.leap.energy\",\"publisher\":{\"@id\":\"https://docs.incentives.leap.energy/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device#webpage\",\"url\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device\",\"name\":\"Save a device\",\"description\":\"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\",\"dateModified\":\"2026-08-17T13:04:32.053Z\",\"isPartOf\":{\"@id\":\"https://docs.incentives.leap.energy#website\"},\"breadcrumb\":{\"@id\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Devices\",\"item\":\"https://docs.incentives.leap.energy/api-reference/devices/search-device-catalog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Saved devices\",\"item\":\"https://docs.incentives.leap.energy/api-reference/devices/list-saved-devices\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Save a device\",\"item\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device#apireference\",\"headline\":\"Save a device\",\"name\":\"Save a device\",\"description\":\"Add a catalog device to your saved list, or relabel one you already saved. Repeating the call updates the existing entry instead of adding a second one. A catalog device Leap has retired returns 404.\",\"url\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device\",\"mainEntityOfPage\":{\"@id\":\"https://docs.incentives.leap.energy/api-reference/devices/save-a-device#webpage\"},\"dateModified\":\"2026-08-17T13:04:32.053Z\",\"publisher\":{\"@id\":\"https://docs.incentives.leap.energy/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.incentives.leap.energy#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Leap Incentives Gateway\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Leap Incentives Gateway","nav":{"global":null,"groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/index"},{"title":"Quickstart","href":"/quickstart"},{"title":"Requirements reference","href":"/setup-data-preferences"}]},{"group":"VPP Offers","pages":[{"title":"How VPP offers are priced","href":"/vpp-offers/how-offers-are-priced"}]},{"group":"Incentives","pages":[{"title":"Incentives Guide","href":"/api-reference/incentives-lookups/overview"},{"title":"Eligibility check codes","href":"/api-reference/incentives-lookups/eligibility-codes"},{"title":"Look up incentives","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-incentives.json post /beta/incentives/lookups","href":"/api-reference/incentives-lookups/look-up-incentives"},{"title":"Refresh incentives","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-incentives.json post /beta/incentives/refreshes","href":"/api-reference/incentives-lookups/refresh-incentives"},{"title":"Override incentives","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-incentives.json post /beta/incentives/overrides","href":"/api-reference/incentives-lookups/override-incentives"}]},{"group":"Applications","pages":[{"title":"Applications Guide","href":"/api-reference/applications/overview"},{"title":"Search applications","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json get /applications","href":"/api-reference/applications/search-applications"},{"title":"Get application","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json get /applications/{application_id}","href":"/api-reference/applications/get-application"},{"title":"Update application","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json patch /applications/{application_id}","href":"/api-reference/applications/update-application"},{"group":"Attachments","pages":[{"title":"List attachments","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json get /applications/attachments","href":"/api-reference/applications/list-attachments"},{"title":"Upload attachment","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json post /applications/attachments","href":"/api-reference/applications/upload-attachment"},{"title":"Commit attachment upload","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json post /applications/attachments/commit","href":"/api-reference/applications/commit-attachment-upload"},{"title":"Download attachment","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json get /applications/attachments/{id}/download","href":"/api-reference/applications/download-attachment"},{"title":"Delete attachment","deprecated":null,"version":null,"openapi":"/api-reference/specs/incentives-applications.json delete /applications/attachments/{id}","href":"/api-reference/applications/delete-attachment"}]}]},{"group":"Programs","pages":[{"title":"List programs","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-programs.json get /beta/incentives/programs","href":"/api-reference/programs/list-programs"},{"title":"Get a program","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-programs.json get /beta/incentives/programs/{program_id}","href":"/api-reference/programs/get-a-program"},{"title":"List approved devices","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-programs.json get /beta/incentives/programs/{programIdentifier}/approved-devices","href":"/api-reference/programs/list-approved-devices"}]},{"group":"Devices","pages":[{"title":"Search device catalog","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json get /beta/incentives/devices/search","href":"/api-reference/devices/search-device-catalog"},{"group":"Saved devices","pages":[{"title":"List saved devices","description":"List the devices you've saved, most recently saved first. Each entry carries the full catalog record plus your own optional label. Saving the products you sell keeps them on hand without a catalog search every time. Results are scoped to your account; page through them with `limit` and `offset`.","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json get /beta/incentives/devices/saved","href":"/api-reference/devices/list-saved-devices"},{"title":"Save a device","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json put /beta/incentives/devices/saved/{device_id}","href":"/api-reference/devices/save-a-device"},{"title":"Remove a saved device","description":"Remove a device from your saved list. The catalog device is untouched, and so is any lookup that referenced it. Removing a device you have not saved also returns 204, so retries are safe.","deprecated":null,"version":null,"openapi":"/api-reference/specs/gcs-devices.json delete /beta/incentives/devices/saved/{device_id}","href":"/api-reference/devices/remove-a-saved-device"}]}]}]},"title":"Save a device - Leap Incentives Gateway","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}