---
title: "Pre-warm sessions cache for the active project"
url: https://docs.gleap.ai/en/reference/rest-api/warmup-sessions
method: POST
path: "/sessions/warmup"
api: "API Reference"
tag: "Session"
operationId: "WarmupSessions"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Pre-warm sessions cache for the active project

`POST https://api.gleap.io/v3/sessions/warmup`

Pre-warm OpenSearch shards + Redis list cache for the active project. Fire-and-forget: returns {ok:true} immediately while the warmup runs in the background. Triggered from the frontend right before a session query is likely (sidebar hover, global search modal mount, RecipientPicker mount, periodic refresh while on the Sessions page) so the user doesn't pay the cold-shard penalty on first interaction.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Headers

- `project` (string, required)

## Example request

```bash
curl --request POST \
  --url https://api.gleap.io/v3/sessions/warmup \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok

- `ok` (boolean, required)

```json
{
  "ok": true
}
```