Menu
Platform
AI
App store purchases
Database
Flags
Jobs and cron
Localization
Monitoring
Notifications
Payments
Queues
Sandboxes
Webhooks
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
Expire in KV
Sets a key's time to live (EXPIRE) without rewriting its value; zero makes it persistent.
Sets a key's time to live (EXPIRE) without rewriting its value; zero makes it persistent.
- Path
POST https://api.data.sylphx.com/v1/kv-expiries - Scope
data:write - Effect
write— a successful call changes state. - Collection kv
- Host
https://api.data.sylphx.com
#Request
| Field | Type | What it is |
|---|---|---|
namespace_id | string | The namespace's id. Required. |
key | string | The key. Required. |
ttl_seconds | uint64 | Seconds to live, at most one year; zero makes the key persistent. Required. |
#Response
| Field | Type | What it is |
|---|---|---|
applied | bool | Whether the key existed and its expiry was set. |
version | uint64 | The key's version (an expiry does not change it). |
expires_at_unix_ms | int64 | The new expiry in Unix milliseconds; zero never expires. |
#Errors
UNAUTHENTICATED— No valid key or token was presented.PERMISSION_DENIED— The key lacks the method's permission.INVALID_FIELD— A field failed validation.RESOURCE_NOT_FOUND— The named Resource does not exist or is not visible.
Every error arrives in the body Errors describes.
#Examples
curl -X POST "https://api.data.sylphx.com/v1/kv-expiries" \
-H "Authorization: Bearer $SYLPHX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"key":"…","namespace_id":"…","ttl_seconds":1}'