---
title: "POST /_system/redis_keys - Redis Keys · RUAL Documentation"
description: "Create a new Redis key pattern configuration (requires setting_redis_keys permission)"
canonical: https://docs.rual.nl/cluster/api/redis-keys/system-redis-keys-post
language: en
---

# POST /_system/redis_keys

Create a new Redis key pattern configuration (requires setting_redis_keys permission)

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **[authorization](https://docs.rual.nl/cluster/api#token-providing)** required | `string` | `"Bearer access_token"` | Access token |

| Key | Type | Example | Description |
| --- | --- | --- | --- |
| **key** required | `string` | `"user:{user_id}:session"` | Redis key pattern (no spaces allowed) |

```
{
  "_meta": {
    "created": 1782166695,
    "entity": 1,
    "guid": "a23575f49d0af385314c1f02280163374297e018a692e5e4ab85eb307ebf6ebc",
    "modified": 1782166695,
    "updated": 1782166695
  },
  "cache_hit_count": 0,
  "key": "user:{user_id}:session",
  "pins": [
    {}
  ]
}
```

```
{
  "error": "INSUFFICIENT_PERMISSIONS"
}
```

| Status | Error Code | Description |
| --- | --- | --- |
| `401` | `INSUFFICIENT_PERMISSIONS` | Permission or validation error |

| Permission | Description |
| --- | --- |
| `Bearer token` | Access token required via Authorization header, x-authtoken, x-token, query param, or cookie |
| `redis_keys_create` | Required scope: redis_keys_create |