{"docsConfig":{"theme":"sequoia","$schema":"https://mintlify.com/docs.json","name":"Empirical","colors":{"primary":"#000000","light":"#D4D4D4","dark":"#000000"},"logo":{"light":"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=70362d47336d0836bb176c00f9359062","dark":"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=76c038abc85166ca88f23025b50a54f5"},"favicon":"https://mintcdn.com/empirical/WYHhMc-3Yp_VenHe/logo/favicon.svg?fit=max\u0026auto=format\u0026n=WYHhMc-3Yp_VenHe\u0026q=85\u0026s=fbcfc3b86055b3f672438c9f79378fc2","api":{"playground":{}},"appearance":{"default":"system","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#161616"}},"navbar":{"links":[{"href":"https://empirical.run/home","label":"Home"}],"primary":{"type":"button","label":"Dashboard","href":"https://empirical.run/login"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"empirical","hasAudioNarration":false,"actualSubdomain":"empirical","customDomains":["empirical.run"],"gitSource":{"type":"github","owner":"empirical-run","repo":"test-generator","deployBranch":"main","contentDirectory":"external-docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae7531ec01b8679a4af9f2e","collectionId":"3e6efa0a-91bb-4c74-848f-97a6c5de706a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae7531ec01b8679a4af9f2e"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae7531ec01b8679a4af9f2e","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"Guides","count":25},{"language":"default","tag":"Failure Groups","count":10},{"language":"default","tag":"Features","count":9},{"language":"default","tag":"Test Runs","count":8},{"language":"default","tag":"Snoozes","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Analytics","count":5},{"language":"default","tag":"Environments","count":5},{"language":"default","tag":"KV","count":5}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx3cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxTcwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxPcwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx_cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPx7cwhsk.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: 'JetBrains Mono';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/jetbrainsmono/v24/tDbv2o-flEEny0FZhsfKu5WU4zr3E_BX0PnT8RD8yKwBNntkaToggR7BYRbKPxDcwg.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*{border-radius:0!important}::selection{background:#5f5;color:#000}.dark ::selection{background:oklch(.62 .16 328);color:#161616}li[data-active-nav-item=true]>a{background:#000;color:#fff!important;text-shadow:none}li[data-active-nav-item=true]>a *{color:inherit!important}li[data-active-nav-item=true]>a svg{background-color:currentColor!important}.dark li[data-active-nav-item=true]>a{background:#d4d4d4;color:#161616!important}code,kbd,pre{font-family:\"JetBrains Mono\",ui-monospace,monospace!important}.dark #topbar-cta-button a>span{background:#d4d4d4}.dark #topbar-cta-button a :is(span, svg){color:#161616}.dark #navbar div:has(>div>.nav-tabs),.dark #search-bar-entry{background:#1e1e1e}.dark #navbar div:has(>div>.nav-tabs){border-top:1px solid #2f2f2f}"}],"page":{"pagePath":"api-reference/kv/refresh-a-kv-entrys-ttl","slug":"/api-reference/kv/refresh-a-kv-entrys-ttl","pageMetadata":{"title":"Refresh a KV entry's TTL","description":"Resets the entry's TTL without resending its value, e.g. to extend a lock lease. Send `If-Match: \u003cversion>` to refresh only an unchanged entry.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/kv/{key}","href":"/api-reference/kv/refresh-a-kv-entrys-ttl","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Resets the entry’s TTL without resending its value, e.g. to extend a lock lease. Send \", _jsx(_components.code, {\n children: \"If-Match: \u003cversion>\"\n }), \" to refresh only an unchanged entry.\"]\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":{"config":{},"pageMetadata":{"title":"Refresh a KV entry's TTL","description":"Resets the entry's TTL without resending its value, e.g. to extend a lock lease. Send `If-Match: \u003cversion>` to refresh only an unchanged entry.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/kv/{key}","href":"/api-reference/kv/refresh-a-kv-entrys-ttl","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["KV"],"operationId":"refreshKvEntry","summary":"Refresh a KV entry's TTL","description":"Resets the entry's TTL without resending its value, e.g. to extend a lock lease. Send `If-Match: \u003cversion>` to refresh only an unchanged entry.","parameters":["11f3c977-b346-401c-9c13-fc41ec6bf191","12221352-1bea-4531-99b1-7d985f5b4269"],"requestBody":"28a8bc75-b374-4605-b7d3-55613a542a19","responses":{"200":"ce91d40a-5489-4819-acf7-69016ac06153","400":"8c7b3a14-87f6-4bfe-822c-1020114ddf4a","404":"f8344f1c-4523-4a51-951d-5dc7849c8626","412":"ed6bb8eb-ac14-4cf9-8c7e-bfb4a9f996e0","503":"60a5b467-a3be-47d6-b24d-48baca21c528"},"method":"patch","type":"path","servers":["7f1173af-53ac-4d7c-be61-79db501420f9"],"security":["f04d1695-8406-4e74-b1ce-21eddcd099e5"],"path":"/api/kv/{key}","baseUrlOptions":["https://api.empirical.run"],"title":"Refresh a KV entry's TTL","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"11f3c977-b346-401c-9c13-fc41ec6bf191":{"schema":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,512}$","description":"Key, 1-512 characters from `A-Z a-z 0-9 . _ : -`. Use `:` to namespace keys, e.g. `pw-lock:1234:user-settings`.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"Key, 1-512 characters from `A-Z a-z 0-9 . _ : -`. Use `:` to namespace keys, e.g. `pw-lock:1234:user-settings`.","name":"key","in":"path"},"12221352-1bea-4531-99b1-7d985f5b4269":{"schema":{"type":"string","pattern":"^(?:W\\/)?\"?\\d+\"?$","description":"Apply only if the entry's current `version` equals this value (its `ETag`).","isRequired":false,"uniqueKey":"","typeLabel":"string"},"required":false,"description":"Apply only if the entry's current `version` equals this value (its `ETag`).","name":"if-match","in":"header"}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ttl":{"type":"integer","minimum":1,"maximum":2592000,"description":"Time-to-live in seconds (max 30 days).","isRequired":true,"uniqueKey":"ttl","typeLabel":"integer"}},"required":["ttl"],"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"ttl":1296000}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"ce91d40a-5489-4819-acf7-69016ac06153":{"description":"The refreshed entry.","headers":{"ETag":{"schema":{"type":"string","description":"The entry's `version`, for use in `If-Match`."},"required":true,"description":"The entry's `version`, for use in `If-Match`."}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"entry":{"type":"object","properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,512}$","description":"Key, 1-512 characters from `A-Z a-z 0-9 . _ : -`. Use `:` to namespace keys, e.g. `pw-lock:1234:user-settings`.","isRequired":true,"uniqueKey":"data.entry.key","typeLabel":"string"},"version":{"type":"integer","minimum":1,"description":"Increments on every write. Send it as `If-Match` to make a write conditional.","isRequired":true,"uniqueKey":"data.entry.version","typeLabel":"integer"},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry expires.","isRequired":true,"uniqueKey":"data.entry.expires_at","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry was first written.","isRequired":true,"uniqueKey":"data.entry.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of the latest write or TTL refresh.","isRequired":true,"uniqueKey":"data.entry.updated_at","typeLabel":"string\u003cdate-time>"},"written_by":{"oneOf":[{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["user"],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"User ID.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.0.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.0","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["chat_session"],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Chat session ID.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.1.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.1","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["test_run"],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Test run ID.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.2.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.2","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["api_key"],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Project API key ID.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.3.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.3","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["system"],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"id":{"oneOf":[{"type":"string","minLength":1,"description":"Service name, when known.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.4.id.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"description":"Service name, when known.","isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.4.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.4.id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"data.entry.written_by.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"data.entry.written_by","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"data.entry.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"data.entry.value.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"data.entry.value.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"oneOf":[{},{"type":"null","uniqueKey":"data.entry.value.oneOf.3.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"data.entry.value.oneOf.3.items.[INDEX]","typeLabel":"null"},"description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"data.entry.value.oneOf.3","typeLabel":"null[]"},{"type":"object","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"data.entry.value.oneOf.4.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.entry.value.oneOf.4.additionalProperties","typeLabel":"null"},"uniqueKey":"data.entry.value.oneOf.4","typeLabel":"object"},{"type":"null","uniqueKey":"data.entry.value.oneOf.5","typeLabel":"null"}],"uniqueKey":"data.entry.value","typeLabel":"string | number | boolean | null[] | object | null"}},"required":["key","version","expires_at","created_at","updated_at","written_by"],"isRequired":true,"uniqueKey":"data.entry","typeLabel":"object"}},"required":["entry"],"description":"Response payload.","isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"entry":{"key":"\u003cstring>","version":2,"expires_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","written_by":{"kind":"user","id":"\u003cstring>"},"value":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"8c7b3a14-87f6-4bfe-822c-1020114ddf4a":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f8344f1c-4523-4a51-951d-5dc7849c8626":{"description":"No entry under this key.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ed6bb8eb-ac14-4cf9-8c7e-bfb4a9f996e0":{"description":"The `If-Match` or `If-None-Match` condition did not hold.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"current":{"oneOf":[{"type":"object","properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,512}$","description":"Key, 1-512 characters from `A-Z a-z 0-9 . _ : -`. Use `:` to namespace keys, e.g. `pw-lock:1234:user-settings`.","isRequired":true,"uniqueKey":"error.current.oneOf.0.key","typeLabel":"string"},"version":{"type":"integer","minimum":1,"description":"Increments on every write. Send it as `If-Match` to make a write conditional.","isRequired":true,"uniqueKey":"error.current.oneOf.0.version","typeLabel":"integer"},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry expires.","isRequired":true,"uniqueKey":"error.current.oneOf.0.expires_at","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry was first written.","isRequired":true,"uniqueKey":"error.current.oneOf.0.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of the latest write or TTL refresh.","isRequired":true,"uniqueKey":"error.current.oneOf.0.updated_at","typeLabel":"string\u003cdate-time>"},"written_by":{"oneOf":[{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["user"],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.0.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"User ID.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.0.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.0","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["chat_session"],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.1.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Chat session ID.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.1.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.1","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["test_run"],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.2.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Test run ID.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.2.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.2","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["api_key"],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.3.kind","typeLabel":"enum\u003cstring>"},"id":{"type":"string","minLength":1,"description":"Project API key ID.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.3.id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.3","typeLabel":"object"},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["system"],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.4.kind","typeLabel":"enum\u003cstring>"},"id":{"oneOf":[{"type":"string","minLength":1,"description":"Service name, when known.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.4.id.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"description":"Service name, when known.","isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.4.id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.4.id","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"error.current.oneOf.0.written_by","typeLabel":"object"},"value":{"oneOf":[{"type":"string","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"error.current.oneOf.0.value.oneOf.0","typeLabel":"string"},{"type":"number","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"error.current.oneOf.0.value.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"error.current.oneOf.0.value.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"oneOf":[{},{"type":"null","uniqueKey":"error.current.oneOf.0.value.oneOf.3.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"error.current.oneOf.0.value.oneOf.3.items.[INDEX]","typeLabel":"null"},"description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","uniqueKey":"error.current.oneOf.0.value.oneOf.3","typeLabel":"null[]"},{"type":"object","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","additionalProperties":{"oneOf":[{},{"type":"null","uniqueKey":"error.current.oneOf.0.value.oneOf.4.additionalProperties.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.current.oneOf.0.value.oneOf.4.additionalProperties","typeLabel":"null"},"uniqueKey":"error.current.oneOf.0.value.oneOf.4","typeLabel":"object"},{"type":"null","uniqueKey":"error.current.oneOf.0.value.oneOf.5","typeLabel":"null"}],"uniqueKey":"error.current.oneOf.0.value","typeLabel":"string | number | boolean | null[] | object | null"}},"required":["key","version","expires_at","created_at","updated_at","written_by"],"description":"The entry as it is now, or `null` if the key does not exist.","isRequired":true,"uniqueKey":"error.current.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"key":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,512}$","description":"Key, 1-512 characters from `A-Z a-z 0-9 . _ : -`. Use `:` to namespace keys, e.g. `pw-lock:1234:user-settings`."},"value":{"oneOf":[{"type":"string","description":"The stored JSON value. Omitted from list responses unless `include_values=true`."},{"type":"number","description":"The stored JSON value. Omitted from list responses unless `include_values=true`."},{"type":"boolean","description":"The stored JSON value. Omitted from list responses unless `include_values=true`."},{"type":"array","items":{"oneOf":[{},{"type":"null"}]},"description":"The stored JSON value. Omitted from list responses unless `include_values=true`."},{"type":"object","description":"The stored JSON value. Omitted from list responses unless `include_values=true`.","additionalProperties":{"oneOf":[{},{"type":"null"}]}},{"type":"null"}]},"version":{"type":"integer","minimum":1,"description":"Increments on every write. Send it as `If-Match` to make a write conditional."},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry expires."},"created_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when the entry was first written."},"updated_at":{"type":"string","format":"date-time","description":"ISO 8601 timestamp of the latest write or TTL refresh."},"written_by":{"oneOf":[{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["user"]},"id":{"type":"string","minLength":1,"description":"User ID."}}},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["chat_session"]},"id":{"type":"string","minLength":1,"description":"Chat session ID."}}},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["test_run"]},"id":{"type":"string","minLength":1,"description":"Test run ID."}}},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["api_key"]},"id":{"type":"string","minLength":1,"description":"Project API key ID."}}},{"type":"object","description":"Who last wrote or refreshed the entry.","required":["kind","id"],"properties":{"kind":{"type":"string","enum":["system"]},"id":{"oneOf":[{"type":"string","minLength":1,"description":"Service name, when known."},{"type":"null","minLength":1,"description":"Service name, when known."}]}}}]}},"required":["key","version","expires_at","created_at","updated_at","written_by"],"description":"The entry as it is now, or `null` if the key does not exist.","isRequired":true,"uniqueKey":"error.current.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"error.current","typeLabel":"object | null"}},"required":["message","current"],"description":"Error details with the current entry.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>","current":{"key":"\u003cstring>","version":2,"expires_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","written_by":{"kind":"user","id":"\u003cstring>"},"value":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"60a5b467-a3be-47d6-b24d-48baca21c528":{"description":"KV store not configured.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"description":"Always null for error responses.","isRequired":true,"uniqueKey":"data.oneOf.0","typeLabel":"any"},{"description":"Always null for error responses.","type":"null","isRequired":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data","typeLabel":"any | null"},"error":{"type":"object","properties":{"message":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["message"],"description":"Error details.","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["data","error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":"\u003cunknown>","error":{"message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"f04d1695-8406-4e74-b1ce-21eddcd099e5":{"Bearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"Bearer"}}},"servers":{"7f1173af-53ac-4d7c-be61-79db501420f9":{"url":"https://api.empirical.run"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"api-reference/openapi.generated.json"},"subdomain":"empirical","siteName":"Empirical","title":"Refresh a KV entry's TTL - Empirical","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-31T08:27:11.290Z","originalFileLocation":"api-reference/kv/refresh-a-kv-entrys-ttl.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Resets the entry\u0026#x27;s TTL without resending its value, e.g. to extend a lock lease. Send If-Match: to refresh only an unchanged entry.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Empirical\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_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=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Refresh a KV entry\u0026#x27;s TTL - Empirical\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resets the entry\u0026#x27;s TTL without resending its value, e.g. to extend a lock lease. Send If-Match: to refresh only an unchanged entry.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Empirical\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://empirical.mintlify.app/_mintlify/api/og/v2?division=KV\u0026amp;title=Refresh+a+KV+entry%27s+TTL\u0026amp;description=Resets+the+entry%27s+TTL+without+resending+its+value%2C+e.g.+to+extend+a+lock+lease.+Send+%60If-Match%3A+%3Cversion%3E%60+to+refresh+only+an+unchanged+entry.\u0026amp;theme=f70f53f39fe8b87f817734d5\u0026amp;signature=738c4f59055ecdb22181be5c282d402e07c5345dc5d58e389d0172439d4bbf92\">\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=\"Refresh a KV entry\u0026#x27;s TTL - Empirical\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resets the entry\u0026#x27;s TTL without resending its value, e.g. to extend a lock lease. Send If-Match: to refresh only an unchanged entry.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://empirical.mintlify.app/_mintlify/api/og/v2?division=KV\u0026amp;title=Refresh+a+KV+entry%27s+TTL\u0026amp;description=Resets+the+entry%27s+TTL+without+resending+its+value%2C+e.g.+to+extend+a+lock+lease.+Send+%60If-Match%3A+%3Cversion%3E%60+to+refresh+only+an+unchanged+entry.\u0026amp;theme=f70f53f39fe8b87f817734d5\u0026amp;signature=738c4f59055ecdb22181be5c282d402e07c5345dc5d58e389d0172439d4bbf92\">\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=\"/docs/mintlify-assets/_mintlify/favicons/empirical/d75TlCq_n_9QZcB_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Empirical\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/kv/refresh-a-kv-entrys-ttl.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://empirical.run/#organization\",\"name\":\"Empirical\",\"url\":\"https://empirical.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/empirical/6QELjdPJQ3LR0pOP/logo/wordmark-light.svg?fit=max\u0026auto=format\u0026n=6QELjdPJQ3LR0pOP\u0026q=85\u0026s=70362d47336d0836bb176c00f9359062\"}},{\"@type\":\"WebSite\",\"@id\":\"https://empirical.run/docs#website\",\"name\":\"Empirical\",\"url\":\"https://empirical.run/docs\",\"publisher\":{\"@id\":\"https://empirical.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl#webpage\",\"url\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl\",\"name\":\"Refresh a KV entry's TTL\",\"description\":\"Resets the entry's TTL without resending its value, e.g. to extend a lock lease. Send If-Match: to refresh only an unchanged entry.\",\"dateModified\":\"2026-10-31T08:27:11.290Z\",\"isPartOf\":{\"@id\":\"https://empirical.run/docs#website\"},\"breadcrumb\":{\"@id\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"KV\",\"item\":\"https://empirical.run/docs/api-reference/kv/list-kv-entries\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Refresh a KV entry's TTL\",\"item\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl#apireference\",\"headline\":\"Refresh a KV entry's TTL\",\"name\":\"Refresh a KV entry's TTL\",\"description\":\"Resets the entry's TTL without resending its value, e.g. to extend a lock lease. Send If-Match: to refresh only an unchanged entry.\",\"url\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl\",\"mainEntityOfPage\":{\"@id\":\"https://empirical.run/docs/api-reference/kv/refresh-a-kv-entrys-ttl#webpage\"},\"dateModified\":\"2026-10-31T08:27:11.290Z\",\"publisher\":{\"@id\":\"https://empirical.run/#organization\"},\"isPartOf\":{\"@id\":\"https://empirical.run/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Empirical\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Empirical","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Test Runs","pages":[{"title":"List test runs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs","href":"/api-reference/test-runs/list-test-runs"},{"title":"Trigger a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json put /api/test-runs","href":"/api-reference/test-runs/trigger-a-test-run"},{"title":"Get a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs/{id}","href":"/api-reference/test-runs/get-a-test-run"},{"title":"List test run artifacts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/test-runs/{id}/artifacts","href":"/api-reference/test-runs/list-test-run-artifacts"},{"title":"Cancel a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/cancel","href":"/api-reference/test-runs/cancel-a-test-run"},{"title":"Re-run a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/test-runs/{id}/re-run","href":"/api-reference/test-runs/re-run-a-test-run"},{"title":"Skip a test run","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v1/test-runs/skip","href":"/api-reference/test-runs/skip-a-test-run"},{"title":"Get test run metadata","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-runs/{id}","href":"/api-reference/test-runs/get-test-run-metadata"}]},{"group":"Test Cases","pages":[{"title":"List test cases","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases","href":"/api-reference/test-cases/list-test-cases"},{"title":"Get a test case","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases/{id}","href":"/api-reference/test-cases/get-a-test-case"},{"title":"Update test case tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/v2/test-cases/{id}","href":"/api-reference/test-cases/update-test-case-tags"},{"title":"List test case tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/test-cases/tags","href":"/api-reference/test-cases/list-test-case-tags"}]},{"group":"Environments","pages":[{"title":"Create an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/environments","href":"/api-reference/environments/create-an-environment"},{"title":"Delete an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/environments/{id}","href":"/api-reference/environments/delete-an-environment"},{"title":"Update an environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/environments/{id}","href":"/api-reference/environments/update-an-environment"},{"title":"List environments","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/environments/list","href":"/api-reference/environments/list-environments"},{"title":"Sync environments from YAML","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/environments/sync","href":"/api-reference/environments/sync-environments-from-yaml"}]},{"group":"Snoozes","pages":[{"title":"List snoozes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/snoozes","href":"/api-reference/snoozes/list-snoozes"},{"title":"Create a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/snoozes","href":"/api-reference/snoozes/create-a-snooze"},{"title":"Get a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/snoozes/{id}","href":"/api-reference/snoozes/get-a-snooze"},{"title":"Delete a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/snoozes/{id}","href":"/api-reference/snoozes/delete-a-snooze"},{"title":"Update a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/snoozes/{id}","href":"/api-reference/snoozes/update-a-snooze"},{"title":"Add tests to a snooze","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/snoozes/{id}/add-test-cases","href":"/api-reference/snoozes/add-tests-to-a-snooze"}]},{"group":"KV","pages":[{"title":"List KV entries","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/kv","href":"/api-reference/kv/list-kv-entries"},{"title":"Get a KV entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/kv/{key}","href":"/api-reference/kv/get-a-kv-entry"},{"title":"Write a KV entry","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json put /api/kv/{key}","href":"/api-reference/kv/write-a-kv-entry"},{"title":"Delete a KV entry","description":"Deletes the entry under `key`. Send `If-Match: \u003cversion>` to delete only an unchanged entry (e.g. release a lock you still hold).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/kv/{key}","href":"/api-reference/kv/delete-a-kv-entry"},{"title":"Refresh a KV entry's TTL","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/kv/{key}","href":"/api-reference/kv/refresh-a-kv-entrys-ttl"}]},{"group":"Analytics","pages":[{"title":"Test-case execution history (batch)","description":"Returns per-test-case execution history for the requested test cases, plus echoed query metadata.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v2/analytics/test-case-history/batch","href":"/api-reference/analytics/test-case-execution-history-batch"},{"title":"Last passing run per environment","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/v2/analytics/test-case-last-pass-per-env","href":"/api-reference/analytics/last-passing-run-per-environment"},{"title":"Test-case analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-cases","href":"/api-reference/analytics/test-case-analytics"},{"title":"Test-count analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-count","href":"/api-reference/analytics/test-count-analytics"},{"title":"Test-run analytics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/v2/analytics/test-runs","href":"/api-reference/analytics/test-run-analytics"}]},{"group":"Badges","pages":[{"title":"Get an environment status badge","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/badges/projects/{project_slug}/environments/{environment_slug}","href":"/api-reference/badges/get-an-environment-status-badge"}]},{"group":"Failure Groups","pages":[{"title":"List failure groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups","href":"/api-reference/failure-groups/list-failure-groups"},{"title":"Create a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups","href":"/api-reference/failure-groups/create-a-failure-group"},{"title":"Get a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}","href":"/api-reference/failure-groups/get-a-failure-group"},{"title":"Delete a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json delete /api/failure-groups/{id}","href":"/api-reference/failure-groups/delete-a-failure-group"},{"title":"Update a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/failure-groups/{id}","href":"/api-reference/failure-groups/update-a-failure-group"},{"title":"Get a failure group's activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}/activity","href":"/api-reference/failure-groups/get-a-failure-groups-activity"},{"title":"List a failure group's members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/{id}/members","href":"/api-reference/failure-groups/list-a-failure-groups-members"},{"title":"Attach a failing test to a failure group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups/{id}/members","href":"/api-reference/failure-groups/attach-a-failing-test-to-a-failure-group"},{"title":"Merge a failure group into another","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/failure-groups/{id}/merge","href":"/api-reference/failure-groups/merge-a-failure-group-into-another"},{"title":"List a run's failure-group members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/failure-groups/members","href":"/api-reference/failure-groups/list-a-runs-failure-group-members"}]},{"group":"Files","pages":[{"title":"List files","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/files","href":"/api-reference/files/list-files"},{"title":"Create a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json post /api/files","href":"/api-reference/files/create-a-file"},{"title":"Get a file","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/files/{id}","href":"/api-reference/files/get-a-file"},{"title":"Confirm a file upload","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json patch /api/files/{id}","href":"/api-reference/files/confirm-a-file-upload"}]},{"group":"Reporter Configuration","pages":[{"title":"List reporters","deprecated":null,"version":null,"openapi":"/api-reference/openapi.generated.json get /api/reporters","href":"/api-reference/reporter-configuration/list-reporters"}]}]}]},"basePath":"","title":"Refresh a KV entry's TTL - Empirical","buildId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","deploymentId":"dpl_6cCEiK8XNNvaLBBkWzcBhdE9QfLC","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CLz2_Z5D.js","utils-7A5jZhOT.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BVWmkKuv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-4SOfrh0F.js","snippetPresets-CMc8KicP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-DeQN5MDd.js","ApiExamples-Ba9tX7z3.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Be8krXvv.js","shallow-CBC3K1uB.js","getApiPlaygroundDisplay-4tKcUAYo.js","CodeSnippet-C1Xa06ft.js","CodeSnippets-vqiz27A_.js","getPastedJson-NUwRfM32.js","icon-DkIVqWh9.js","MethodPill-qmhT7_wz.js","DuplicateIcon-_gWp1vhn.js","createIcon-NA1p_TVA.js","DynamicMarkdown-Bas9A7wq.js","SectionHeading-a1cS-24U.js","axios-vUo_bRtp.js","Markdown-D3ZTwq_a.js","clsx-BcghKhHb.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-B66mVNPp.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DmooSyTN.js"]}