---
title: "Refresh a record summary"
url: https://docs.gleap.ai/en/reference/rest-api/refresh-summary
method: POST
path: "/records/{recordType}/{recordId}/summary/refresh"
api: "API Reference"
tag: "Records"
operationId: "RefreshSummary"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Refresh a record summary

`POST https://api.gleap.io/v3/records/{recordType}/{recordId}/summary/refresh`

Regenerates the summary, bypassing the staleness cooldown. Rate limited to once a minute per record — the cooldown is what bounds automatic spend, so the manual path needs its own floor or it becomes the way around it.

## Authorization

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

## Path parameters

- `recordType` (string, required)
- `recordId` (string, required)

## Headers

- `project` (string, required)

## Example request

```bash
curl --request POST \
  --url 'https://api.gleap.io/v3/records/{recordType}/{recordId}/summary/refresh' \
  --header 'Authorization: Bearer <token>' \
  --header 'project: <project>'
```

## Responses

### 200 (`application/json`)

Ok

- `status` (enum<string>, required): One of: `disabled`, `not-enabled`, `not-enough-data`, `ok`, `not-found`, `rate-limited`.
- `summary` (any)
- `stale` (boolean): True when the record has moved on but the cooldown is still holding.

```json
{
  "status": "disabled",
  "stale": true
}
```