# Key-Value Store

> Skill `kv` on Faro. Free. 3 sub-skills.

A simple persistent key-value store: save, retrieve, and delete named values across requests. Values can optionally expire after a set number of hours. Useful for agents and applications that need to remember small pieces of data between calls, such as a session state, a counter, or a cached result.

**Category:** Developer Tools  
**Tags:** memory, state, key-value, storage, persistence  
**Use when:** You need to stash a small value between calls and read it back later by key.  
**Not for:** Large blobs or files (use the file share), or structured records you query (use tables).  
**Returns:** information

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/kv/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Remember that my session token is abc123"}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run kv "Remember that my session token is abc123"
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Remember that my session token is abc123
- What is the value stored under "task_status"?
- Delete the stored value for "task_status"

## Sub-skills

### Set a value

Stores a value under a key, optionally expiring after a number of hours.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/kv/set.md

---

### Get a value

Reads the value stored under a key.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/kv/get.md

---

### Delete a value

Deletes the value stored under a key.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/kv/delete.md

---

---
On the web: https://askfaro.com/search/kv