# RERANK.CREATE

> Create a rerank cache namespace with an optional entry limit and default TTL.

URL: https://docs.hotkv.com/commands/rerank-create/

```
RERANK.CREATE namespace [MAX_ENTRIES n] [TTL seconds]
```

- Group: Keyed caches
- Complexity: O(1)
- HotKV Cloud: Performance and Scale plans
- On-Premise: requires the rerank-cache license feature

The rerank cache stores cross-encoder rerank scores for a query and document pair in a retrieval pipeline, so a repeated pair does not have to be scored again. `RERANK.CREATE` creates a namespace. You must create a
namespace before you can store entries in it with [RERANK.SET](https://docs.hotkv.com/commands/rerank-set/index.md).

## Options

| Option | Effect |
| --- | --- |
| `MAX_ENTRIES n` | Maximum number of entries. `0` or omitted uses the server's per-namespace limit, and larger values are capped at that limit (`max_entries_per_namespace` under `[rerank]`). When the namespace is full, HotKV evicts existing entries to make room, expired entries first. |
| `TTL seconds` | Default time to live for entries stored without their own `TTL`. `0` or omitted means entries do not expire. |

Options can be given in any order and are case-insensitive.

## Return value

| Case | RESP2 | RESP3 |
| --- | --- | --- |
| Namespace created | Simple string `OK` | Same |

Errors:

- `ERR namespace already exists or limit reached` if the namespace exists, or the server already holds its maximum number of rerank cache namespaces (`max_namespaces` under `[rerank]`).
- `ERR invalid MAX_ENTRIES` or `ERR invalid TTL` if a value is not a non-negative integer.
- `ERR unknown option` for any other option name.
- `ERR wrong number of arguments for 'rerank.create' command` if the argument count is wrong.
- `NOLICENSE rerank-cache requires a HotKV license. Contact sales@hotkv.com` if your license does not include the `rerank-cache` feature.

## Examples

```
127.0.0.1:6379> RERANK.CREATE rerank_scores MAX_ENTRIES 1000000 TTL 3600
OK
127.0.0.1:6379> RERANK.CREATE rerank_scores
(error) ERR namespace already exists or limit reached
```

## Compatibility

HotKV-only command. Redis and Valkey have no equivalent.

## See also

[RERANK.SET](https://docs.hotkv.com/commands/rerank-set/index.md), [RERANK.GET](https://docs.hotkv.com/commands/rerank-get/index.md), [RERANK.DEL](https://docs.hotkv.com/commands/rerank-del/index.md), [RERANK.STATS](https://docs.hotkv.com/commands/rerank-stats/index.md), [RERANK.FLUSH](https://docs.hotkv.com/commands/rerank-flush/index.md), [RERANK.DROP](https://docs.hotkv.com/commands/rerank-drop/index.md), [RERANK.LIST](https://docs.hotkv.com/commands/rerank-list/index.md), [AI features guide](https://docs.hotkv.com/ai-features/index.md)