---
title: "List keys."
method: POST
path: "/v1/kv/keys"
tags: ["Key-Value"]
---

# List keys.

`POST /v1/kv/keys`

## Request

- Base URL: `https://api.scalix.world`
- URL: `https://api.scalix.world/v1/kv/keys`
- Auth: HTTP bearer

Returns the keys in the tenant's key-value store matching an optional glob pattern.

## Request body

- KvKeysRequest: Body for `/v1/kv/keys` — list keys matching an optional glob pattern.
  - `pattern` string, nullable: Glob pattern; defaults to `*` (all keys) when omitted.

## Response `200`

`{ keys: [string] }` matching the pattern

## Other responses

- `401`: Missing or invalid API key
- `500`: Internal error

---

[API](https://skmtc.dev/scalix/apis/scalix-cloud-api.md) · [All operations](https://skmtc.dev/scalix/apis/scalix-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scalix/apis/scalix-cloud-api/revisions/2c04ca0a90bb?raw)