Upstash

App · Databases · 3 actions

Read and write key-value data in your Upstash Redis database: get a key's value, set a value (with an optional expiry), and delete a key.

Actions

ActionWhat it does
Delete keyDelete a key from your Upstash Redis database.
Get valueGet the value stored at a key in your Upstash Redis database.
Set valueStore a value at a key in your Upstash Redis database, overwriting any existing value.

Delete key

Delete a key from your Upstash Redis database. Returns deleted=false when the key did not exist.

Inputs

KeykeytextRequired
The Redis key to operate on, for example 'user:42:session'.

Outputs

deletedtrue/false
True when the key existed and was removed; false when it did not exist.
keytext
The key targeted for deletion.
Example output
{
  "deleted": true,
  "key": "greeting"
}

Get value

Get the value stored at a key in your Upstash Redis database. Returns found=false when the key does not exist.

Inputs

KeykeytextRequired
The Redis key to operate on, for example 'user:42:session'.

Outputs

foundtrue/false
True when the key exists.
keytext
The key that was looked up.
valuetext
The stored value, or null when the key does not exist.
Example output
{
  "found": true,
  "key": "greeting",
  "value": "Hello from Lodol"
}

Set value

Store a value at a key in your Upstash Redis database, overwriting any existing value. Optionally have the key expire automatically after a number of seconds.

Inputs

KeykeytextRequired
The Redis key to operate on, for example 'user:42:session'.
ValuevaluetextRequired
The value to store for this key. Stored as text; convert numbers or JSON to text first if needed.
Expire after (seconds)ttl_secondsnumber
Optional. Automatically delete the key this many seconds after it is set (Redis EX). Leave blank to keep it until it is deleted.

Outputs

keytext
The key that was written.
successtrue/false
True when the value was stored.
ttl_secondsnumber
The expiry applied in seconds, or null when the key does not expire.
Example output
{
  "key": "greeting",
  "success": true,
  "ttl_seconds": null
}

On this page