Delete data

Disposing of your data

All values submitted are disposable and are automatically destroyed after some time of inactivity (i.e. not accessed for some time). 90 days is the default, but the period can be made shorter, or longer with &ttl=[days] parameter.

Time-To-Live (TTL)

You don't have to wait for a period of inactivity to purge your data. You can pass a Time-To-Live directive with each /write call, which will cause saved values to be purged - as in permanently deleted - after N number of days.

ttl=<number-of-days>

Example: the 'theme' setting for user janedoe will be erased after 15 days. Any other values associated with that key will not be affected - unless they also were set with an explicit ttl value.

https://prefs.us/write/?key=...&user=janedoe&theme=default-dark&ttl=15

IMPORTANT: TTL parameter is enforced at a value level, meaning it only affects key/value pair it was assigned to and does not apply to other values associated with your key.

Key expiration

Keys expire when they become inactive, meaning they have not been accessed for a period of time with a /read endpoint. When a key hasn't been used in some time, it will have reached its expiration, and so, it will be subsequently deleted from the system and all data associated with that key will be purged as well.