K
Docs
API Reference→Pieces→Get One Row
🔎

Get One Row

vault.getThe VaultVault

Like Read from Vault, but for when you want one row: the first one that matches. Its columns become sparks directly — {{row.coins}} instead of {{result.0.coins}}. Filter with = ≠ > < ≥ ≤, contains or starts with.

When to use this
  • →Use the Missing path to welcome people who don't have a row yet
  • →Need every matching row? That's Read from Vault

On the canvas

This is what Get One Row looks like when you place it on your flow. Each field below is something you configure in the inspector panel.

🔎
Get One Row
vault.get
Vault
tablerequired
Pick a table…
filterColumn
Every row
filterOp
select…
filterValue
e.g. {{input.user.id}}
asrequired
row
found
missing

Config fields

FieldTypeReqWhat it does
table
Pick a table…
textyesTable 🗄️
filterColumn
Every row
text—Only rows where… 🔍
filterOpselect—Is…
filterValue
e.g. {{input.user.id}}
text—This value
as
row
textyesSave it as ✨

Output ports

foundA row matched
missingNothing matched — great for first-timers
📐

In TypeScript, this would be…

Not something you need to write — just a look at what Kitcord does for you.

TypeScript
const row = await db.get(
  "SELECT * FROM wallets WHERE user_id = ? LIMIT 1",
  [userId],
);
// {{row.coins}} — Found ✓, or Missing ∅ when row is undefined